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PREFACE 



The Text Editor (also known as the EDIT program) is a part of the Network Operating 
System (hereinafter called NOS or the system) for CONTROL DATA® CYBER 170 
aQvioq iv/f/>,^ai 172 fT^ 174. anri 17C; r'/->TVTi->n +£»■»• Qtto+ptv^o r>no nvTa'CT? 7n qoi^-iQC! 

Model 72, 73, and 74 Computer Systems, and CDC 6000 Series Computer Systems. 
Its purpose is to effect character-oriented data manipulations from a remote terminal. 

This manual contains the information a user must have to use the Text Editor. 

Section 1 introduces the Text Editor and summarizes its general capabilities. 

Section 2 defines fundamental concepts and terminology i nherent in Text Editor u sa ge. 

Section 3 contains descriptions of each of the EDIT commands, including pertinent 
examples of each general type of command. Certain commands are mutually related 
and these relationships are depicted in the examples. 

The Text Editor user who needs basic information pertaining to system access and 
file management can refer to appendices A and B. For additional information about 
NOS software, refer to the current versions of the following manuals. 

Control Data Publications Publication No. 



NOS Reference Manual Volume 1 60435400 

NOS Reference Manual Volume 2 60445300 

NOS Time-Sharing User's Reference Manual 60435500 

NOS Terminal User's Instant Manual 60435800 

This product is intended for use only as described in this document. Control Data Corpora- 
tion cannot be responsible for the proper functioning of undescribed features or undefined 
parameters. 
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INTRODUCTION 



GENERAL 

ing session or in a batch job. From a terminal, it is an interactive package; that is, 
the user enters a command, EDIT interprets the command and executes it, after which 
the user can enter another conunand to be executed, and so forth. This manual is pre- 
sented from a time-sharing orientation. Batch usage is outlined in appendix D. 

TEXT EDITOR CAPABILITY 

Using Text Editor commands, the user can manipulate edit file data in the following 
ways (appropriate command words are shown in parentheses). 

Print a file, either in part or in entirety (LIST, FIND) 

Erase information from a file (DELETE, BLANK) 

Add information to a file (ADD, INSERTS) 

Replace information in a file with other information (CHANGE, RS) 

Move information to and from a temporary holding area for subsequent 
insertion (EXTRACT, CLEAR) 

Combine the contents of two files (MERGE) 

Obtain a count that reflects the number of times a specified combination of 
characters occurs in the edit file (NUMBER) 

Determine the line number of the file at which Text Editor is currently 
positioned (LINE) 

Direct Text Editor activity to a specific area of the edit file (SET, RESET, FIND) 

Control edit file and page format (LENGTH. WIDTH, ALIGN, DEFTAB, 
LISTAB, TAB) 

Terminate the editing session (END) 
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EDIT OPERATrONS 

An edit command consists of a command word, followed optionally by a string speci- 
fication and an n parameter. 

The Text Editor command repertoire allows three basic types of operations. 

1. Line mode operations are addressed to one or several entire lines of text 
in the edit file. 

2. String mode operations are addressed to a sequence of characters, as indicated 
by a string specification that follows the command word, A string mode 
command word always ends with an S. A string mode command with an empty 
string specification has exactly the same effect as a line mode command. 

3. Edit control commands are not addressed to specific lines or strings of text. 
In general, they perform such necessary functions as search-pointer control, 
format control, large-scale file manipulations, and exit from the Text Editor 
program. 

CONVENTIONS 

The symbol @ is used throughout to denote the carriage return key (or its equivalent). 

In the examples, the terminal printout has occasionally been expanded to accomodate 
the commentaries. 



1-2 
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This section describes the fundamental concepts and terms associated with the Text 
Editor as a preparation for the discussion of the edit commands. Included are such 
subjects as entering Text Editor, general command syntax, and string manipiilation 
proceuures. 

ENTERING TEXT EDITOR 

After log in is completed, the user enters Text Editor by typing in the EDIT command. 
The full form of this command is: 

EDIT, Hn p m, Ifng, Kng 

or 

EDIT, FN=lfni, M=m, I=lfn2, L=lfn3 

The first form.at is order dependent; the second is order independent. The parameters 
have the following values: 

Ifnj Name of the file to be edited. Default is the primary file. 

m Mode of file processing 

N Normal 

AS ASCII 

For a time-sharing session, default is whatever mode the term.in£il was 
in when Text Editor was entered. For a batch job, default is normal. 

Ifn2 The file from which the edit commands are to be read. Defaiilt is 

input from the terminal. 

Ifng The file on which the output is to be written. The default is output 

at the terminal. 

The user will frequently want to use default versions of the EDIT command. Thus the 
entry 

EDIT @ 

calls Text Editor and performs editing on the primary file with directives entered at 
the terminal. Output is printed at the terminal using the existing character set m.ode. 

The defa\]lt entry 

EDIT,lfn @ 

calls Text Editor and performs editing on the local file Ifn with directives entered at 
the terminal. Output is printed at the terminal using the existing character set mode. 
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After the EDIT command is entered, the system replies: 
BEGIN TEXT EDITING. 

This message indicates that the Text Editor program is initiated and awaiting commands. 
The program is designed to process only the Text Editor commands discussed in sec- 
tion 3 of this manual. Thus, the regular time- sharing commands are illegal until an 
exit is made from Text Editor. It may be necessary to enter and exit Text Editor 
several times during an editing session in order to use features not available under 
EDIT control (refer to Terminating Edit Session at the end of section 3). 

The Text Editor may be called from any of the time-sharing subsystems. It can also 
be called from a local or remote batch job. Use of the Text Editor from a batch job 
is covered in appendix D. 



CAUTION 






Text Editor operates on a single record only. 
If it is entered with a multirecord file, all but 
the first record is lost (refer to the NOS Time- 
Sharing User's Reference Manual, section 3, 
Pile Sorting), 

Some Text Editor commands are powerfid and 
can rtiin a file if improperly used. Therefore, 
the user should generally have a copy of the file 
being edited. To create a copy of a direct ac- 
cess or local file, refer to COPY control state- 
ments, NOS Reference Manual Voliune 1, A 
working file can be saved prior to editing (refer 
to appendix B). 

It is possible to enter Text Editor with an empty file and develop it diiring the edit 
session. Refer to Adding and Building Text in section 3. 

EDIT FILE 

The Text Editor operates on only one edit file at any given time. The edit file can 
be the primary file, a working file, or a direct access permanent file, and is speci- 
fied when entering Text Editor with the EDIT command. All changes to the edit file 
are reflected in the original working file or direct access file. The edit file has a 
line limit of 150 characters. Lines longer than 150 characters are truncated. 



CAUTION 



Editing a read-only file may cause unpre- 
dictable results. 



2-2 60436100 C 



SEARCH POINTER 

The search pointer is a place marker that indicates a particular line of the edit file. 
Unless command parameters indicate otherwise, the operation im.plied by the command 
word is performed on the line indicated by the search pointer. In any case, all action 
on a file begins relative to the search pointer. 

The sesirch pointer is set at the beginning of the edit file when EDIT is initiated. The 
SET, FIND, RESET, and LENGTH commands are used to change its value, and are 
the only commands capable of doing so. 

A command that operates on more than one line of the edit file always begins opera- 
tion at the line indicated by the search pointer (or relative to that line). 

EDIT COMMANDS (GENERAL FORMAT) 

Each editing operation on the edit file is specified by an edit command. An edit com- 
mand may consist of the following four elements. 

1. Command word 

2. String specification, consisting of zero, one, or two string fields 

3. n parameter, consisting of a positive integer 

4. Comment 

Blanks have no significance in the Text Editor command language. They are permitted 
between the letters of the command word and between the com.ponents of the comLinand, 

The string specification and/or the n parameter are not used with certain commands, 
and commientary is optional with all conmaands. 

The general form of an edit command is: 

< cmwd> < strdef > < n> < com.ment> 
where : 

< cmwd> Any EDIT command word, or short form thereof, as listed in 

Command Words 

< strdef > One of the following string definitions. 

:< string> , < string> 

:< string> 

omitted 

<string> consists of a nonzero number of alphanumeric char- 
acters, bounded on each end by a nonblank character (called a 
delimiter). In most comm.ands the string identifies the part of 
the edit file being sought, although In several commands the 
string has a special purpose (for example, refer to MERGE 
command). The delimite r s o n ea ch end must be the sam.e char- 
acter, "must not be the character $ or blank, and cannot be used 
within the string. 
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< n> One of the following. 

omitted 

n is an integer or an asterisk. The integer is positive, except 
that a negative n is permitted if < cin-wd> is SET. An asterisk 
implies an n value equal to the number of text lines or appear- 
ances of a string in the edit file from the search pointer to the 
end of the file. 

< comment> A comment, if included, consists of a dollar sign ($), followed 

by any sequence of characters ending with the @ , It has no 
effect on the operation of the command. 

The entire command, including comment, must be on one line. Pressing the carriage 
retiim signifies the end of the command. Only one command is permitted on a single 
line, 

LINE MODE AND STRING MODE 

Some edit conunands have two modes of operation, line mode and string mode. In a 
line mode command, all operations are performed with a line of the edit file as the 
basic unit of operation. In a string mode command, all operations are performed 
with a character string as the basic unit of operation. The string may be a portion 
of a line or may extend over several lines. 



NOTE 



It is important not to confuse string mode with the 
search string used in both line mode and string mode 
edit commands. The search string specifies the point 
or area of the edit file to which the command operation 
is directed. The string mode refers to the nature of 
the command operation. 

A string mode command with an empty search string specification has the same action 
as the corresponding line mode command. 
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COMMAND WORDS 

The command word determines the operation to be performed. The EDIT command 
words are listed with their corresponding short forms (if any) shown in parentheses. 



Line Command Words 



ADD 


(A) 


BLANK 


(B) 


CHANGE 


(C) 


DELETE 


(D) 


EXTRACT 


(E) 


FIND 


(F) 


LIST 


(L) 


NUMBER 


(N) 



String Command Words 



ADDS 


(AS) 


BLANKS 


(BS) 


CHANGES 


(CS) 


DELETES 


(DS) 


ES 




FINDS 


(FS) 


INSERTS 


(IS) 


LISTS 


(LS) 


NUMBERS 


(NS) 


RS 





Control Command Words 



ALIGN 


(AL) 


CLEAR 


(CD 


DEFTAB 


(DT) 


END 




LENGTH 




LINE 


(LN) 



LISTAB 


(LT) 


MERGE 


(M) 


RESET 


(R) 


SET 


(S) 


TAB 


(T) 


WIDTH 


(W) 



STRINGS AND DELIMITERS 

A string is a sequence of alphanumeric characters that may include blanks and special 
characters. Strings are used in two ways. 

1. In the <strdef> field of a Text Editor command 

2. In response to an ENTER TEXT request 

The two ends of the string must be explicitly defined by a pair of matching characters 
called delimiters. A delimiter is any nonblank character except a dollar sign ($) and 
is chosen by the user. 
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The delimiter character can be used within the string only in response to an ENTER 
TEXT request. If, however, such an embedded character (identical to the delimiter 
character) appears at the end of a line (for example, the last character entered prior 
to a carriage return). Text Editor interprets the character as the closing delimiter and 
the ENTER TEXT request is terminated. EDIT tests for the closing delimiter only 
after a carriage return. 

Use of the delimiter character within the <strdef> field of a Text Editor command is 
not allowed and if used EDIT responds : 

<cmwd> SYNTAX ERROR. 

(In this manual the character / (slash or virgule) is used to denote a delimiter in the 
presentation of command formats, ) 

Correct String Definition 

/ABCDE/ 

/THE FORMAT OF/ 

BALWAYS IS B 

? INT(R*TAN(2*M))? 

Incorrect String Definition 

/THIS STATEMENT WILL (no closing delimiter) 

(HOWEVER) (different delimiter characters) 

ANY COMMAND TERMINATED BY/ (unintended beginning delimiter) 

$THIS LOOKS LIKE A COMMENT$ (illegal delimiter character) 



Improper or unintended string definitions are common 
errors, and because of the powerful nature of som^e 
Text Editor comnaands. are potentially destructive to 
a file. 

SEARCH STRING PARAMETER 

The search string parameter of an EDIT command indicates to the Text Editor where 
the operation is to be performed. If no search string is given in a command, the 
operational location depends solely on the setting of the search pointer. If a search 
string is given, the operation specified is performed with respect to the first occurrence 
of the string after the beginning of the line indicated by the search pointer. 
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If the specified string does not occur after the beginning of the line indicated by the 
search pointer, the following message is printed. 

PHRASE NOT FOUND. 

The search string must be specified to identify uniquely the string being sought. If 
too small a string is given, the search may result in operating on an occurrence of 
the string that was not the intended target. 

A search string is given in two forms, a single phrase or an ellipsis. 

SINGLE PHRASE SEARCH STRING 

In a single phrase search string, the entire string of consecutive characters is placed 
between a pair of delimiters. The string can include as many characters as required 
(subject to the requirement that the entire command be on a single line), and the 
search is satisfied only when an identical string is found within a single line of the 
edit file. 

ELLIPSIS SEARCH STRING 

An ellipsis search string specification consists of two delimited bracket strings, 
separated by a comma. The search process attempts to locate a string of consecutive 
characters that begins with the first phrase and ends with the second phrase. The 
string implied by an ellipsis search string may appear in the file over more than one 
line. 

Example : 

The ellipsis search string 

.•/FORM/, /LONG/ 
is satisfied by the string underlined. 

THE ELLIPSIS IS A FORM OF SHORTHAND FOR LONG OR MULTILINE STRINGS. 

One frequent source of error in using ellipsis search strings is a tendency to make 
the bracket strings too short. Consider the following text. 

AS ANOTHER EXAMPLE, ASSUME THAT THE TARGET STRING EXTENDS OVER 
SEVERAL LINES LIKE THIS ONE. 

If the underlined string is to be referenced, a command with the following string 
specification might be entered. 

:/THE/,/ONE/ 

This does not reference the string desired, however, because the first occurrence of 
THE is in the word ANOTHER. The string specification 

:/THE T/,/ONE/ 

identifies the underlined string properly. 
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SPECIAL STRING FIELDS 

A special string has a format similar to that of a search string. Its interpretation 
depends on the command word with which it appears. The following are the three 
types of special string fields and the statements with which they are used. 

• Tab stop sequence in a TAB command 

• Tab character defined in a DEFTAB command 

• Merge file name in a MERGE command 

n PARAMETER 

The n parameter is an integer whose meaning depends on the context in which it 
appears; its use adds flexibility to EDIT commands. The following are possible inter- 
pretations, 

• The number of lines on which a command is to be performed 

• The rnimber of strings on which a command is to be performed 

• The number of lines the search pointer is to be moved forward or backward 

• The length of a file in lines or the maximimi width of the lines in character 
columns 

• The point in a file where new data is to be inserted 

When omitted, n is assumed to equal 1 if applicable. The n parameter is not applicable 
for the commands RESET, LINE, LISTAB, CLEAR, NUMBER(S), DEFTAB, and END. 
Negative values of n are allowed only in a SET command. 

An asterisk (*) instead of a number in the n parameter indicates that the operation is 
performed at or until the end of the edit file. Refer to the description of the particular 
command of interest for specific details. 

DOCUMENTARY COMMENTS 

To annotate the editing session (possibly for review purposes), append a dollar sign 
to any or all commands and follow the dollar sign with commentary information. The 
comment is ignored by the editor. 

STRING BUFFER 

The string buffer is a temporary storage area for information that is to be moved 
within the edit file. 

Information is copied from the edit file into the string buffer using the EXTRACT 
command. This information may then be inserted elsewhere in the file, using the 
ADD or CHANGE command. 
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After the ADD or CHANGE command is entered, the system responds; 

ENTER TEXT. 
? 

If the user responds by typing: 



on the same line, the contents of the string bxiffer are inserted into the edit file at 
the point or points indicated by the ADD or CHANGE command. 

The CLEAR command erases the contents of the string btiffer. CLEAR is used -when- 
ever the contents of the string buffer is no longer needed. Until a CLEAR command 
is issued, repeated EXTRACT operations cause extracted strings to appear ctimulatively 
in the string buffer, concatenated in the order of their extraction. 

ENTER TEXT REQUEST 

The Text Editor issues an ENTER TEXT request in response to an ADD command and 
in response to a CHANGE command. 

After the ENTER TEXT request, type an opening delimiter, followed by the body of 
text to be entered, and then followed by a closing delimiter. The delimiters do not 
become part of the actual file. 

The delimiter character is the first nonblank character entered in response to the 
ENTER TEXT request. The closing delimiter is the first recurrence of the delimiter 

uno.J.'fX^ l/CJL' itllcLl, JLO xOj^Ow^U J.iru.iJ.cuJ.cxbOi.jr Uj a, «^Ct.i, X j-ci^o XCUUXll. X Xi-C UOXXXi.lXI>CX ^^xicxx civ^bcjx 

may occur in the actiial text if it is not immediately followed by a carriage return. 

The delimiter may be any nonblank character except a dollar sign ($). If a blank or 
a dollar sign is entered as a delimiter from an interactive job, EDIT responds with: 

ILLEGAL DELIMITER - REENTER TEXT. 
? 

For a local or remote batch job, EDIT issues the following error message to the user's 
dayfile: 

ILLEGAL DELIMITER. 

expecting the next statement in the INPUT file to be a new command. 

For time- sharing origin jobs, the Text Editor types a question mark at the beginning 
of each line until the closing delimiter appears. The system then responds: 

READY. 
? 

The READY message indicates that the next line entered is treated as an edit com- 
mand. 
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If a blank line is desired in the text, at least one space must be entered on a line 
and then followed with a carriage return. If the closing delimiter followed with a 
carriage return appears on a line by itself, a blank line is added to the text file. 
If a carriage return alone is entered on a line, a final blank line is added to the 
text and an exit from the enter text mode occurs (that is, a return to command mode). 

PROCESSING TERMINAL INTERRUPTS 

The time-sharing user may control his edit session through use of terminal interrupts. 
He exercises these interrupts \mder three circiimstances. 

• While output is being transmitted to his terminal. The transmission of output 
to a terminal is terminated on an ASCII Code terminal by pressing the BREAK, 
I, or S key; on a correspondence code terminal by pressing the ATTN key. 
One of the main uses of this type of interrupt is the termination of unwanted 
output from execution of a LIST command. 

• While he is entering text in response to an ADD or CHANGE command. 

Typing STOP after entering text in response to an ADD or CHANGE command 
terminates the command and the user is given the choice of retaining or dis- 
carding the text just entered. The system does this by typing 

DISREGARD PREVIOUS TEXT ? 

If the user types NO after the question mark, the system responds with 

READY. 
? 

In this case, the text entered is included in the edit file and the system awaits 
a new edit command. If the user types YES in response to the question, the 
system responds with 

READY. 
? 

The text just entered is disregarded and the system awaits a new edit com- 
mand. 

• While the system is processing a command he has entered. If an edit com- 
mand is in execution, the user may contingently terminate execution by typing 
STOP. The system gives the output status of the command in execution and 
then prints the enquiry 

CONTINUE COMMAND ? 

If the user types YES after the question mark, processing continues; if he types 
NO, processing term.inates. 



NOTE 



Typing STOP after the execution of an edit 
command immediately terminates the edit 
session. Refer to Terminating Edit Session 
for additional information. 
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EDIT COMMANDS 



This section describes the allowable formats for each Text Editor command and rules 
governing their use. The commands are grouped by general category of function; for 
example, the removal of information category includes the DELETE and BLANK 
commands. 

A group of contextual examples is included at the end of each category. These 
examples are designed to illustrate the effect of the various formats, and in particular, 
to clarify the differences between similar commands. 



ENTERING COMMANDS 

All Text Editor commands are entered at the time-sharing terminal or included in a batch 
job according to the general format described in section 2 of this manual. After an 
edit command is typed and @ is pressed, the Text Editor either processes the 
command immediately or requests additional information. In general, each edit com- 
mand operation is performed relative to the current position of the search pointer. 
Appendix C contains a summary of all Text Editor messages and requests. For batch 
origin jobs, commands are entered from an input file (refer to appendix D). 

TEXT LISTING AND SEARCH POINTER CONTROL 

LIST COMMAND 

The LIST command allows the operator to print all or selected portions of the edit 
file. The printout can include a string of characters, a single line, a set of lines 
each including a common character string, or a set of contiguous lines. 

If an asterisk is specified in the n parameter or if the value of the n parameter 
extends beyond the end of the edit file, all remaining lines are printed, followed by 

-END OF FILE- 

If an ellipsis string is specified, a line mode command causes all lines to be printed 
that contain any portion of the ellipsis string. A string mode command prints only 
the string implied by the ellipsis. 
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LINE MODE FORMATS (LIST OR L] 

Command 
LIST 

LIST;n 
LIST: /string/ 

LIST:/string/;n 

LIST.7stringl/, /string2/ 
LIST:/stringl/, /string2/;n 



Explanation 

Prints the line of text specified by the search 
pointer. 

Prints n lines of contiguous text, beginning 
at the search pointer. (If n equals *, all 
xLLix^a lu me ciiu (ji me euii lue are prinxea. ) 

Prints the line containing the specified string (the 
phrase must be contained in a single line). Search 
for string begins at current position of search 
pointer. 

Prints the first n lines containing the string 
(n can equal *, in which case all lines in 
the edit file that contain the string are 
printed). 

Prints the line or group of lines containing 
the ellipsis stringl through string2 . 

Prints the first n occurrences of lines or 
groups of lines containing the ellipsis stringl 
through string2. 



STRING MODE FORMATS (LISTS OR LS) 

Command 

LISTS 

LISTS;n 
LISTS: /string/ 



LISTS:/string/;n 
LISTS:/stringl/, /string2/ 

LISTS: /stringl/, /string2/;n 



Explanation 



Same as LIST. 



Same as LIST;n. 

Prints the specified string, if present in the edit 
file. Search for string begins at current position 
of search pointer. 

Prints the first n occurrences of the string. 

Prints the string of characters specified \>y 
the ellipsis /stringl/, /string2/. 

Prints the first n occurrences of the string 
of characters specified by the ellipsis 
/stringl/, /string2/. 
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SEARCH POINTER CONTROL (SET AND RESET} 

EDIT initially locates the search pointer at the first line of the edit file. With the SET 
command, the search pointer can be moved to a particular line in the edit file without 
listing it. The RESET command sets the search pointer to the first line of the edit 
file, regardless of its former position. Activity on the edit file always begins at the 
current search pointer setting. 



SET COMMAND (SET OR S| 

The following are the four forms of the SET command. 



Command 



SET 



SET;n 
SET;-n 



or 



SET: /string/ 



SET:/string/;n 



Explanation 



Advances the search pointer one line relative 
to its current setting. 

Advances (or sets back) the search pointer n 
lines relative to its current setting. If the SET 
instruction results in a negative search pointer 
(the pointer being set back past the beginning 
of the file), the pointer is set to the first line. 
(If n equals -^ or extends beyond the end of the 
file, the pointer is set to the end of the edit 
file. ) 

Moves the search pointer to the line containing 
the string, relative to the current setting of the 

string, the search pointer is not moved. 

Moves the search pointer forward from its 
current setting to the beginning of the line 
containing the nth occurrence of the search 
string; if there are less than n occurrences, 
the search pointer is positioned at the last line 
containing the string. 



The SET command requires locational information, 
the use of an n parameter is implied. 



H no search string is present. 



Only single-phrase search strings are allowed. Ellipsis search strings are not allowed. 

Using a search string without an n parameter moves the search pointer from its current 
setting forward to the line containing the first occurrence of the search string. 



RESET COMMAND (RESET OR R) 

The RESET command brings the search pointer to the beginning of the edit file, 
format is : 



Its 



RESET 
Operand fields are not used with the RESET command. 
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FIND COMMAND 

The FIND command scans the edit file, beginning at the line indicated by the search 
pointer. When a line (or string) is encountered that fulfills the combined requirements 
of the search string and/or the n parameter, the Text Editor lists that line or string 
and sets the search pointer accordingly (as explained in the discussion of the FIND 
formats ). 



If the end of the edit file is reached before the nth occurrence is found, the search 
I pointer is set to the line of the last string found. 



LINE MODE FORMATS (FIND OR F) 

Command 
FIND 

FIND;n 



FIND: /string/ 
FIND .7 string /;n 



FIND:/stringl/, /string2/ 
FIND:/stringl/, /string2/;n 



Explanation 

Advances the search pointer one line and lists 
the line. 

Advances the search pointer n lines and lists 
the line indicated by the new value of the 
search pointer. 

Advances the search pointer to the nth line 
that contains at least one occurrence of 
/string/, and lists the line. 

Advances the search pointer from its current 
position to the nth line that contains the be- 
ginning of the ellipsis search string. If the 
search string is multiline, all lines contain- 
ing some part of the nth occurrence of 
/stringl/, /string2/ are listed, and the search 
pointer is set to the line in which the nth 
occurrence begins. 



STRING MODE FORMATS (FINDS OR FS] 

Command 



Explanation 



FINDS 
FINDS;n 



FINDS: /string/ 
FINDS :/string/;n 



FINDS:/stringl/, /string2/ 
FINDS: /stringl/, /string2/;n 



Same as FIND. 

Same as FIND;n . 

Advances the search pointer to the line contain- 
ing the nth occurrence of /string/ and lists 
the string . 

Advances the search pointer to the line contain- 
ing the beginning of the nth occurrence of 
/stringl/, 7string2/. The string is listed. 
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SEARCH POINTER CONTROL (SET AND RESET} 

EDIT initially locates the search pointer at the first line of the edit file. With the SET 
command, the search pointer can be moved to a particular line in the edit file without 
listing it. The RESET command sets the search pointer to the first line of the edit 
file, regardless of its former position. Activity on the edit file always begins at the 
current search pointer setting. 

SET COMMAND (SET OR S) 

The following are the four forms of the SET command. 

Command Explanation 

SET Advances the search pointer one line relative 

to its current setting. 

SET;n ^^ Advances (or sets back) the search pointer n 

SET;-n lines relative to its current setting. H the SET 

instruction results in a negative search pointer 
(the pointer being set back past the beginning 
of the file), the pointer is set to the first line. 
(If n equals ■■< or extends beyond the end of the 
file, the pointer is set to the end of the edit 
file. ) 

SET: /string/ Moves the search pointer to the line containing 

the string, relative to the current setting of the 
search pointer; if the current line contains the 
string, the search pointer is not moved. 

SET:/ string/ ;n Moves the search pointer forward from its 

current setting to the beginning of the line 
containing the nth occurrence of the search 
string; if there are less than n occurrences, 
the search pointer is positioned at the last line 
containing the string. 

The SET command requires locational information. If no search string is present, 
the use of an n parameter is implied. 

Only single-phrase search strings are allowed. Ellipsis search strings are not allowed. 

Using a search string without an n parameter moves the search pointer from its current 
setting forward to the line containing the first occurrence of the search string. 

RESET COMMAND (RESET OR R| 

The RESET command brings the search pointer to the beginning of the edit file. Its 
format is : 

ftBSET 

Operand fields are not used with the RESET command. 
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FIND COMMAND 

The FIND command scans the edit file, beginning at the line indicated by the search 
pointer. When a line (or string) is encountered that fulfills the combined requirements 
of the search string and/or the n parameter, the Text Editor lists that line or string 
and sets the search pointer accordingly (as explained in the discussion of the FIND 
formats ). 



If the end of the edit file is reached before the nth occurrence is found, the search 
I pointer is set to the line of the last string found. 



LINE MODE FORMATS (FIND OR F) 

Command 
FIND 

FIND;n 



FIND: /string/ 
FIND:/string/;n 



FIND:/stringl/, /string2/ 
FIND:/stringl/, /string2/;n 



Explanation 

Advances the search pointer one line and lists 
the line. 

Advances the search pointer n lines and lists 
the line indicated by the new value of the 
search pointer. 

Advances the search pointer to the nth line 
that contains at least one occurrence of 
/string/, and lists the line. 

Advances the search pointer from its current 
position to the nth line that contains the be- 
ginning of the ellipsis search string. If the 
search string is multiline, all lines contain- 
ing some part of the nth occurrence of 
/stringl/, /string2/ are listed, and the search 
pointer is set to the line in which the nth 
occurrence begins. 



STRING MODE FORMATS (FINDS OR FS) 

Command 



Explanation 



FINDS 

FINDS;n 

FINDS: /string/ 
FINDS:/ string /;n 



FINDS:/stringl/, /string2/ 
FINDS: /stringl/, /string2/;n 



Same as FIND. 

Same as FIND;n . 

Advances the search pointer to the line contain- 
ing the nth occurrence of /string/ and lists 
the string . 

Advances the search pointer to the line contain- 
ing the beginning of the nth occurrence of 
/stringl/, 7string2/. The string is listed. 
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LINE COMMAND {lN} 

The LINE command causes a message to be printed that gives the current setting of 
the search pointer. 

The format is : 

LINE 
The message is; 

FILE AT LINE NUMBER n. 

where n Indicates the line of the edit file to which the search pointer is currently 
pointing. If n is the last line of the file, the words : 

-END OF FILE- 

are included in the message. 

The following example illustrates the use of LIST, FIND, SET, RESET, and LINE 
commands . 



Entry /Response 



Commentary 



EDIT 



5**15 

1./100. 

2.**48 

HUNDRETH*BIGNUMBR 



BEGIN TEXT EDITING. 
? LISTj* 

00010 PROGRAM RANDNUM 
00020 MAINSEED = 5**13 
00030 NEXTSEED 
00040 HUNDRETH 
00050 BIGNUMBR 
00060 FRACTION 
00070 IFRAC = INT (FRACTION) 
00080 DO 20 I = 1,10 
00090 INCRMENT = 

00100 NEXTSEED = NEXTSEED*MAINSEED 
00110 10 INCRMENT = INCRMENT+1 
00120 IF((INCRMENT*IFRAC) . LT. NEXTSEED) 
00130 NEWNUM = INCRMENT 
00140 20 CONTINUE 
00150 END 

-END OF FILE- 
? SET;8 

? L $ LIST LINE, 
00090 INCRMENT = 
? LINE 

FILE' AT LINE NUMBER 9. 
? RESET 

? LIST:ZNEXTSEEDZ;2 
00030 NEXTSEED = 5**15 
00100 NEXTSEED = NEXTSEED*MAINSEED 
? LISTS:*«EXTSEED*r^ 

NEXTSEED 

NEXTSEED NEXTSEED 



List to end of file. 



GO TO 10 



Advance search pointer forward 
eight lines from, current setting. 

Determine position of search pointer 
relative to beginning of file. 
Reset search pointer to beginning. 
List first two occurrences of lines 
containing string /NEXTSEED/. 

List fipfft ■Siree occurrences oi 
string /NEXTSEED/. 
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E ntry/ Response 



Commentary 



? FIND; 8 

00090 INCREMENT = 
? L:/20/,/EN/;2 

00120 IF((INCRMENT*IFRAC) . LT.NEXTSEED) 
00140 20 CONTINUE 
00150 END 

? LISTS:/20/,/EN/;2 
20 TF((INCRMEN 
20 CONTINUE 
00150 EN 

? FINDrlHUNDREDTHI 
PHRASE NOT FOUND. 
? RESET 

? FIND:IHUNDRETHI 
00040 HUNDRETH = 1./100. 
? FS:/IFRAC/;2 



IFRAC 



LN 



12. 



= INT (FRACTION) 
I = 1,10 



FILE AT LINE NUMBER 
? S;-5 
? LIST;2 
00070 IFRAC 
00080 DO 20 
? RESET 
? LS:/13/,/40/j2 

13 
00030 NEXTSEED = 5**15 
00040 

130 NEWNUM = INCRMENT 
00140 
? LINE 

FILE AT LINE NUMBER 
? FS:/13/,/40/;2 

130 NEWNUM = INCRMENT 
00140 
? LINE 

FILE AT LINE NUMBER 
? S;-12 
? LINE 

FILE AT LINE NUMBER 
? S 
? LINE 

FILE AT LINE NUMBER 
? FIND:/FRAC/,/0N/;3 

00120 IF {(INCRMENT* IFRAC) .LT.NEXTSEED) 
00130 NEWNUM = INCRMENT 
00140 20 CONTINUE 
? LN 

FILE AT LINE NUMBER 12. 
? SET: /END/? 2 

1 OCCURANCES OF PHRASE FOUND. 
? L 

00150 END 
? END 

END TEXT EDITING 



1. 



13. 



Advance search pointer and list line. 

List lines containing first two 
GO TO 10 occurrences of ellipsis string 
/20/, /EN/. 

List first two occurrences of 

fininsis strincf 19.0 I f'P.'M/ 



Advance search pointer from current 
setting to line containing string 
/HUNDRETH/. Note that command is 
always relative to search pointer. 
Advance search pointer to line contain- 
ing second occurrence of string 
/IFRAC/ and list string. 

Move search pointer back five lines. 
List two contiguous lines. 

Reset search pointer to beginning of 
edit file. List first two occurrences 
of ellipsis string /13/, /40/. 



2. 



Advance search pointer to line 
containing beginning of second 
occurrence of ellipsis string 
/13/,/40/ and list string. 

Set search pointer back 12 lines. 



Advance search pointer one line. 



Advance search pointer to line 
GO TO 10 containing beginning of third 
occurrence of ellipsis string 
/FRAC/,/ON/ and list lines. 



Advance search pointer to second 
occurrence of string /END/. 
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AQQl^Q AND BUILDING TEXT 

The ADD and INSERTS commands cause new information to be included in the edit file 
at a place specified by the user. 

ADD COMMAND 

An ADD operation requires two sets of information, the location where the text is 
added (supplied in the command) and the actual new inform.ation to be inserted in the 
edit file (supplied by the user in response to the ENTER TEXT request). 

After the command is entered, the system tjrpes: 

ENTER TEXT 
? 

Respond to this request in one of three ways. 

1. Type the actual information to be added (including carriage returns and line 
numbers if required), bracketed with delimiters. 

2. Type the dollar sign ($) character with no delimiters or other characters. 
This causes the current contents of the string buffer to be added. (Informa- 
tion is placed in the string buffer by one or more EXTRACT statements. ) 

3. Type @ only. This causes the data entered in response to the most 
recent ENTER TEXT request to be added. 



NOTE 



Whenever a MERGE command is issued, 
the data entered in response to the most 
recent ENTER TEXT request is lost. In 
this case, no data is added when @l 
only is entered in response to an ENTER 
TEXT request. 

Only single phrase search strings are allowed with this command. Ellipsis search 
string specifications are illegsil. 

With no search string specification in force, the n parameter indicates where the 
insertion shall be made relative to the search pointer. 
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LINE MODE FORMATS (ADD OR A) 

Command 
ADD 

ADD;n 
ADD: /string/ 

ADD:/ string/ ;n 



Explanation 

Inserts text after the line of the edit file 
specified by the search pointer. 

Inserts text after the nth line (counting forward 
from the search pointer) of the edit file. 

Inserts text after the line containing the specified 
string; search for string begins at current position 
of search pointer. 

Inserts text after each of the first n lines 
containing the specified string. 



STRING MODE FORMATS (ADDS OR AS) 

Command 

ADDS 

ADDS;n 
ADDS: /string/ 

ADDS:/string/;n 



Explanation 



Same as ADD. 



Same as ADD;n. 

Inserts text immediately following the specified 
string; search for string begins at current 
position of search pointer. 

Inserts text immediately following each of n 
occurrences of the specified string. 



Line mode ADD commiands cause the addition of text following the end of a particular 
line, whereas string mode ADD commands cause text to be added following a particular 
string of characters. A string mode command without a string specification is equiv- 
alent to a line mode command. 

INSERTS COMMAND (INSERTS OR IS) 

The INSERTS command is similar in purpose to the ADDS command, except that the 
text to be inserted is embedded within the command, thus speeding the interaction. 

The command has the following format. 

INSERTS:/stringl/, /string2/;n 

If the n parameter is omitted, 1 is assumed. 

The character string denoted by string2 is inserted immediately after each of n occur- 
rences of stringl, beginning at the search pointer. Note that /stringl/, /string2/ speci- 
fication is not an ellipsis search string in this command. 
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The following example illustrates the use of ADD and INSERTS commands. 
Entry /Response Commentary 



EDITrFILEl 

BEGIN TEXT EDITING. 
? ADD 

ENTER TEXT 
? / THE ADD COMMAND CAN BE VERY 
? USEFUL WHEN CREATING A TEXTUAL 
? FILE. / 

READY. 
? ADDS:+FILE. + 

ENTER TEXT. 
? /IN FACT, IT IS ONE 
? OF THE FEW METHODS THAT CAN BE 
? USED TO BUILD A DIRECT ACCESS 
? FILE./ 

READY. 
? LIST;* 

THE ADD COMMAND CAN BE VERY 
USEFUL WHEN CREATING A TEXTUAL 
FILE. IN FACT, IT IS ONE 
OF THE FEW METHODS THAT CAN BE 
USED TO BUILD A DIRECT ACCESS 
FILE. 

-END OF FILE- 
? INSERTS : ACCESS/ , /PERMANENT/ 
? FIND; 4 

USED TO BUILD A DIRECT ACCESS PERMANENT 
? AS:, FILE, 

ENTER TEXT 
? T, PROVIDING IT IS THE EDIT FILET 

READY. 
? A;* 

ENTER TEXT 
? = IT IS ALSO USEFUL WHEN ADDING 
? TEXT TO A PREVIOUSLY EXISTING FILE.= 

READY . 
? RESET 
? L' * 

THE ADD COMMAND CAN BE VERY 
USEFUL WHEN CREATING A TEXTUAL 
FILE. IN FACT, IT IS ONE 
OF THE FEW METHODS THAT CAN 
USED TO BUILD A DIRECT ACCESS PERMANENT 
FILE, PROVIDING IT IS THE EDIT FILE. 

IT IS ALSO USEFUL WHEN ADDING 
TEXT TO A PREVIOUSLY EXISTING FILE. 

-END OF FILE- 
? A:/EXISTING/ 

ENTER TEXT. 
?/ LATER IT WILL BE DEMONSTRATED HOW TO 
? USE THE ADD COMMAND TO REMOVE TEXT 
? FRO»-fHE STRING BUFFER./ - 



Text Editor is called, creating empty 
working file FILEl. 

The file is built using the ADD command. 



Text is added immediately after the first 
occurrence of the string /FILE. /. 



List to end of file. 



The string / PERMANENT/ is inserted 

after the first occurrence of the string 

/ACCESS/. 

Text is added directly after the first 

occurrence of the string /FILE/. 



Text is added to the end of the file. 



Reset search pointer to beginning of file 
and list to end of file. 



Add text after the line containing the 
string /EXISTING/. 
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Entry /Response 



Commentary 



READY . 
? S;7 
? L;4 
TEXT TO A PREVIOUSLY EXISTING FILE. 

LATER IT WILL BE DEMONSTRATED HOW TO 
USE THE ADD COMMAND TO REMOVE TEXT 
FROM THE STRING BUFFER. 
? R 

? S:/EDIT FILE/ 
? ADDS 

ENTER TEXT 
? I IT IS ESPECIALLY USEFUL WHEN 
? ADDING TEXT IN THE BODY OF A FILE. I 

READY. 
? L;3 
FILE, PROVIDING IT IS THE EDIT FILE. 

IT IS ESPECIALLY USEFUL WHEN 
ADDING TEXT IN THE BODY OP A FILE. 
? IS:RTEXTUALR,I OR SOURCE! 

PHRASE NOT FOUND. 
? RESET 

?IS:RTEXTUALR,I OF SOURCEI 
? LIST;* 

THE ADD COMMAND CAN BE VERY 
USEFUL WHEN CREATING A TEXTUAL OR SOURCE 
FILE. IN FACT, IT IS ONE 
OF THE FEW METHODS THAT CAN BE 
USED TO BUILD A DIRECT ACCESS PERMANENT 
FILE, PROVIDING IT IS THE EDIT FILE. 

IT IS ESPECIALLY USEFUL WHEN 
ADDING TEXT IN THE BODY OF A FILE. 

IT IS ALSO USEFUL WHEN ADDING 
TEXT TO A PREVIOUSLY EXISTING FILE. 

LATER IT WILL BE DEMONSTRATED HOW TO 
USE THE ADD COMMAND TO REMOVE TEXT 
FROM THE STRING BUFFER. 

-END OF FILE- 
? END 
END TEXT EDITING 



Advance search pointer seven lines. 
List four lines. 



Same as ADD command. 



List three lines of text relative to 
current setting of search pointer. 

Command is relative to position of 
search pointer. 

Add string / OR SOURCE/ directly 
after first occurrence of string 
/TEXTUAL/. 



Listing of altered file. 
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Two types of operation are available for removing information from the edit file, 
DELETE and BLANK, 

DELETE COMMAND 

A DELETE operation erases one or more occurrences of a particular string of characters 
or one or more lines containing a particular string of characters. The text is realigned. 



LINE MODE FORMATS (DELETE OR D) 

Command 
DELETE 

DELETE;n 

DELETE: /string/ 
DELETE:/string/;n 
DELETE :/stringl/, /string2/ 

DELETE:/stringl/, /string2/;n 

STRING MODE FORMATS (DELETES OR 

Command 
DELETES 
DELETES;n 
DELETES: /string/ 
DELETES:/string/;n 

DELETES:/stringl/. /string2/ 

DELETES:/stringl/. /string2/;n 



Explanation 

Erases the line of the edit file specified by 
the search pointer. 

Erases the first n lines of the edit file begin- 
ning at the search pointer. 

Eras eg the line containing the string. 

Erases the first n lines containing the string. 

Erases the line or group of lines containing 
ellipsis / string 1 /, /string2/. 

Erases the first n occurrences of the line or 
group of lines containing ellipsis /stringl/, 
/string2/. 



DS) 



Explanation 

Same as DELETE. 

Same as DELETE;n. 

Erases the specified string. 

Erases the first n occurrences of the speci- 
fied string. 

Erases the string of characters specified by 
the ellipsis /stringl/, /string2/. 

Erases the first n occurrences of the string 
of characters specified by the ellipsis 
/stringl/, /string2/. 
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BLANK COMMAND 



The BLANK command replaces a specified string, line, or set of lines with blank 
characters. Unlike the DELETE command, BLANK does not relocate text. All operations 
begin at the current position of the search pointer. 



LINE MODE FORMATS (BLANK OR B) 

Command 
BLANK 

BLANK;n 

BLANK:/ string/ 

BLANK:/string/;n 

BLANK: /stringl/, /string2/ 

* 

BLANK:/stringl/, /string2/;n 



Explanation 

Replaces with blanks the line of the edit file 
specified by the search pointer. 

Replaces with blanks the first n lines of the 
edit file, beginning at the search pointer. 

Replaces with blanks the line containing the 
string. 

Replaces with blanks the first n lines contain- 
ing the string. 

Replaces with blanks the first line or group 
of lines containing ellipsis /stringl/, /string2/. 

Replaces with blanks the first n occurrences 
of the line or group of lines containing ellipsis 
/stringl/, /string2/. 



STRING MODE FORMATS (BLANKS OR BS) 

Command 
BLANKS 



BLANKS; n 
BLANKS: /string/ 
BLANKS:/string/;n 

BLANKS: /stringl/, /string2/ 

BLANKS: /stringl/, /string2/;n 



Explanation 

Same as BLANK. 

Same as BLANK;n. 

Replaces with blanks the specified phrase. 

Replaces with blanks the first n occurrences 
of the specified phrase. 

Replaces with blanks the string defined by 
the ellipsis /stringl/, /string2A 

Replaces with blanks the first n occurrences 
of the string defined by the ellipsis 
/stringl/, /string2/. 
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The following example illustrates the use of DELETE and BLANK commands. 
Entry /Response Commentary 



EDIT 



BEGIN TEXT EDITING 
? L;* 

00010 PROGRAM RANDNUM 
00020 MAINSEED = 5**13 
00030 NEXTSEED = 5**15 
00040 HUNDRETH = 1./100. 
00050 BIGNUMBR = 2.**48 
00060 FRACTION = HUNDRETH*BIGNUMBR 
00070 IFRAC = INT (FRACTION) 
00080 DO 20 I = 1,10 
000O0 INCRMENT = 

00100 NEXTSEED = NEXTSEED*MAINSEED 
00110 10 INCRMENT = INCRMENT+1 
00120 IF((INCRMENT*IFRAC) . LY. NEXTSEED) 
00130 NEWNUM = INCRMENT 
00140 20 CONTINUE 
00150 END 

-END OF FILE- 
? DELETE ;+BIGNUMBR+;* 

2 OCCURENCES OF PHRASE FOUND. 
? S;3 
? L;2 

00040 HUNDRETK = 1./100. 
00070 IFRAC = INT (FRACTION) 
? A 

ENTER TEXT. 
? /00050 BIG = 2.**48 
? 00060 FRACTION = HUNDRETH*BIG/ 

READY. 
? BLANKS :XHUNDRETHX 
? L;2 

00040 = 1./100. 

00050 BIG = 2.**48 
? IS:/00040 /,/H100/ 
? L 

00040 H100 = 1./100. 

? DS:/ / 

? L 

00040 H100 = 1./100. 

? BLANKS: )UNDRETH) 

? LINE 

FILE AT LINE NUMBER 4. 
? F;2 

00060 FRACTION = H *BIG 
? ADDS:/H/ 

ENTER TEXT. 



List to end of file. 



GO TO 10 



Delete every line in file that contains 

the string /BIGNUMBR/. 

Advance search pointer three lines. 

Lines -5 and 6 have been deleted. 

Add text after line relative to present 
position of search pointer (line 4). 



Blank first occurrence of string 
/HUNDRETH/. 



Insert string /HlOO/ immediately after 
string / 00040 /. 

Delete eight spaces denoted by 
string / /. 

Blank first occurrence of string 
/UNDRETH/, 

Advance search pointer two lines and 
list line. 

Add text after first occurrence of 
string /h/. 
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Entry/ Response 



Commentary 



? /100/ 

READY. 
? L 

00060 FRACTION = H100 *BIG 
? DS:R R 
? L 

00060 FRACTION = H100*BIG 
? R 
? F;13 

00140 20 CONTINUE 
? DS:/20/,/END/ 
? L* * 
00140 

-END OF FILE- 
? IS:*00140 *,*PRINT,NEWNUM* 
? L 

00140 PRINT, NEWNUM 
? A 

ENTER TEXT, 
? /00150 20 CONTINUE 
? 00160 END/ 

READY . 
? RESET 
? LIST;* 

00010 PROGRAM RANDNUM 
00020 MAINSEED = 5**13 
00030 NEXTSED = 5**15 
00040 H100 = 1./100. 
00050 BIG = 2.**48 
00060 FRACTION = H100*BIG 
00070 IFRAC = INT (FRACTION) 
00080 DO 20 I = 1,10 
00090 INCRMENT = 

00100 NEXTSEED = NEXTSEED*MAINSEED 
00110 10 INCRMENT = INCRMENT+1 
00120 IF((INCRMENT*IFRAC) .LT. NEXTSEED) 
00130 NEWNUM = INCRMENT 
00140 PRINT, NEWNUM 
00150 20 CONTINUE 
00160 END 

-END OF FILE- 
? END 

END TEXT EDITING. 



Remove blanks. 



Reset search pointer. 



Delete string specified by ellipsis 

/20/. /END/. 

Note: string deleted, not line. 

Insert string /PRINT, NEWNUM/ 
immediately after string /00140 /. 

Add text after line indicated by search 
pointer. 



Reset search pointer. 



Altered file is listed to end of file. 



GO TO 10 
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SUBSTITUTION OF INFORMATION 

The CHANGE and RS commands each cause a specified set of text information to re- 
place text already present in the edit file. The length of the new information is inde- 
pendent of the length of the replaced text. 

CHANGE COMMAND 

In effect, the CHANGE command combines a DELETE operation with an ADD operation. 
A complete CHANGE operation requires two sets of information, a definition of the 
area to be changed (which is supplied in the CHANGE command) and the information 
that is to be inserted into that area (which is supplied by the user in response to the 
ENTER TEXT request). 

After the command is entered, the system types: 

ENTER TEXT. 
? 

Respond to this request in one of three ways. 

1. Type the actual change information (including carriage returns and line numbers 
if reqtiired), bracketed with delimiters. 

2. Type the dollar sign ($) character with no delimiters or other characters. 
This causes the current contents of the string buffer to be used as the change 
information. (Information is placed in the string buffer by one or more 
EXTRACT statements. ) 

3. Type @ only. This causes the data entered in response to the most recent 
ENTER TEXT request to be used as the change information. 



NOTE 



Whenever a MERGE command is issued, the 
data entered in the most recent ENTER TEXT 
request is lost. In this case, no data is 
added if @ only is entered in response to an 
ENTER TEXT request. 

LINE MODE FORMATS (CHANGE OR C) 

Command Explanation 

CHANGE Replaces the line specified by the search 

pointer with the text that follows. 

CHANGE;n Replaces the first n lines of the edit fUe 

beginning at the search pointer. 

CHANGE :/string/ Replaces the line containing the specified 

string; search for string begins at current 
position of search pointer. 
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Command 



CHANGE : / string / ;n 
CHANGE :/stringl /, /string2 / 

CHANGE :/stringl/, /string2/;n 



Explanation 

Replaces the first n lines containing the string. 

Replaces the line or group of lines containing 
ellipsis /stringl/, /string2/. 

Replaces the first n occurrences of the line 
or group of lines containing ellipsis /stringl/, 

/s+T>inO'2 / 



STRING MODE FORMATS (CHANGES OR CS) 

Conim.and 



CHANGES 

CHANGES;n 

CHANGES:/string/ 

CHANGES :/string/;n 
CHANGESr/stringl/, /string2/ 
CHANGES :/stringl/, /string2/;n 



Explanation 

Same as CHANGE. 

Same as CHANGE;n. 

Replaces the specified string; search for 
string begins at current position of search 
pointer. 

Replaces the first n occurrences of the speci- 
fied string. 

Replaces the string of characters specified by 
the ellipsis /stringl/, /string2/. 

Replaces the first n occurrences of a string 
of characters specified by the ellipsis 
/stringl/, /string2/. 



RS COMMAND 

The RS command is similar to the CHANGE command, except that it performs only 
string replacements and the replacement text is embedded in the command, thus speed- 
ing the interaction. Also, the structure of the RS command does not allow ellipsis 
string specifications. 



There are four valid formats. 
Command 
RS:/string/ 
RS:/string/;n 
RS:/stringl/, /string2/ 

RS:/stringl/, /string2/;n 



Explanation 

Equivalent to DELETESr/string/, 

Eqiiivalent to DELETES:/string/;n. 

Replaces the first occurrence of stringl 
from the search pointer with string2. 

Each of n occurrences of stringl is replaced 
with string2, beginning at the search pointer. 
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The following is an example of CHANGE and RS commands. 

Entry/Response Commentary 



EDIT 



BEGIN TEXT EDITING. 
? L;* 

00010 PROGRAM RANDNUM 
00020 MAINSEED = 5**13 
00030 NEXTSEED = 5**15 
00040 H100 = 1./100. 
00050 eiG = 2.**48 
00060 FRACTION = H100*BIG 
00070 IFRAC = INT (FRACTION) 
00080 DO 20 I = 1,10 
00090 INCRMENT = 

00100 NEXTSEED = NEXTSEED*MAINSEED 
00110 10 INCRMENT = INCRMENT+1 
00120 IF{(INCRMENT*IFRAC) . LT. NEXTSEED) 
00130 NEWNUM = INCRMENT 
00140 PRINT, NEWNUM 
00150 20 CONTINUE 
00160 END 

-END OF FILE- 
? CHANGE 

ENTER TEXT. 
? /00010 PROGRAM RANDOM (OUTPUT)/ 

READY . 
? RS:+NEXTSEED+,+NEXTSD+;* 

4 OCCURANCES OF PHRASE FOUND. 
? F;2 

00030 NEXTSD = 5**15 
? F;7 

00100 NEXTSD = NEXTSD*MAINSEED 
? CS:RSEEDR 

ENTER TEXT. 
? /SD/ 

READY. 
? L 

00100 NEXTSD = NEXTSD*MAINSD 
? RESET 
? CS: /SEED/, /I 5/ 

ENTER TEXT. 
? BSD = 5**13 
? 00030 NEXTSD = 5**178 

READY. 
? L;3 

00010 PROGRAM RANDOM (OUTPUT) 
00020 MAINSD = 5**13 
00030 NEXTSD = 5**17 
? RS :. INCREMENT., .INC. ; 5 
? RS!#FRACTI0N»,#FRAC#;2 



List to end of file. 



GO TO 10 



Change line indicated by current setting 
of search pointer. 



Replace each occurrence of the string 
/NEXTSEED/ with /NEXTSD/. 



Change first occurrence of string 
/seed/ (relative to search pointer) 
with the string /SD/. 



Change ellipsis string specified by 
/SEED/, /15/. 



Replace first five occurrences of string 
/INCRMENT/ with /iNC/ and two 
occurrences of string /FRACTION/ 
with /fMC/. 
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Entry/Response Commentary 

? LS:/INC/;5 

INC 

INC INC 
INC 

INC 
? CHANGE Tq g^^^ ^^^ ^Q ^j^g beginning of the file, 

o«x£,K ibAj.. It IS necessary to use the CHANGE 

? M00005***THIS PROGRAM GENERATES command. 

? 00006* 10 RANDOM NUMBERS BETWEEN 
? 00007* 1 AND 100. 
? 00010 PROGRAM RANDOM (OUTPUT) M 

READY . 
? C:/NEWNUM/,/NEWNUM/ Change line(s) containing ellipsis search 

ENTER TEXT. string /NEWNUM/. /NEWNUM/ 

? /00130 NRAN = INC 
? 00140 PRINT 30, I, NRAN 
? 00145 30 FORMAT{I2,2X,I4)/ 

READY . 
? L;* 

00005***THIS PROGRAM GENERATES 
00006* 10 RANDOM NUMBERS BETWEEN 
00007* 1 AND 100. 
00010 PROGRAM RANDOM (OUTPUT) 
00020 MAINSD = 5**13 
00030 NEXTSD = 5**17 
00040 H100 = 1./100. 
00050 BIG = 2.**48 
00060 FRAC = H100*BIG 
00070 IFRAC = INT (FRAC) 
00080 DO 20 I = 1,10 
00090 INC = 

00100 NEXTSD = NEXTSD*MAINSD 
00110 10 INC = INC+1 

00120 IF ( (INC*IFRAC) .LT. NEXTSD) GO TO 10 
00130 NRAN = INC 
00140 PRINT 30, I, NRAN 
00145 30 FORMAT(I2,2X,I4) 
00150 20 CONTINUE 
00160 END 

-END OF FILE- 
? END 

END TEST EDITING. 
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LOADING THE STRING BUFFER 

The EXTRACT command appends a copy of information from the edit file to the string 
buffer; it does not affect the contents of the edit file in any way. The CLEAR command 
restores the string buffer to an empty condition. Information is transferred from the 
string buffer to the edit file by the ADD or CHANGE commands. 



LINE MODE FORMATS (EXTRACT OR E) 

Command 
EXTRACT 
EXTRACT ;n 

EXTRACT: /string/ 

EXT RACT : / string / ; n 
EXTRACT : / stringl / . / string2 / 

EXTRACT : / stringl / , / string2 / ;n 



Explanation 

Copies one line beginning at the search pointer. 

Copies n lines beginning at the search pointer. 
(If n equals *, all lines to the end of the edit 
file are copied. ) 

Copies the first line containing the string; 
search for string begins at current position of 
search pointer. 

Copies the nth line containing the string. 

Copies the first line or group of lines containing 
ellipsis /stringl/, /string2/. 

Copies the nth occurrence of the line or group 
of lines containing ellipsis /stringl/, /string2/. 



STRING MODE FORMATS (£S} 

Command 
ES 
ES;n 
ES:/string/ 

ES:/string/;n 
ES:/stringl/, /string2/ 

ES:/stringl/, /string2/;n 



Explanation 

Same as EXTRACT. 

Same as EXTRACT ;n. 

Copies the string specified; search for string 
begins at current position of search pointer. 

Copies the nth occurrence of the specified string. 

Copies the string of characters specified by the 
ellipsis /stringl/, /string2/. 

Copies the nth string of characters specified by 
the ellipsis /stringl/, /string2/. 



CLEAR STRING BUFFER (CLEAR OR CL| 

The string buffer is not cleared automatically after an ADD or CHANGE command. 
It is the user's responsibility to clear the string buffer; if he does not do so, infor- 
mation from subsequent EXTRACT operations is appended to the information from 
previous EXTRACT operations. 

The format is : 

CLEAR 

Operand fields are never used with this command. 
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The following example illustrates the use of EXTRACT and CLEAR commands. 
Entry /Response Commentary 



EDIT 

BEGIN TEXT EDITING. 
? LIST;* 



List to end of file. 



VERY USEFUL IN REARRANGING 
LINES OF TEXT. 

-END OF FILE- 
? S;2 
? EXTRACT 
? R 
? ADD 

ENTER TEXT. 

? $ 

READY. 
? L;* 

THE EXTRACT COMMAND CAN BE 
LINES OF TEXT. 
VERY USEFUL IN REARRANGING 
LINES OF TEXT. 

-END OF FILE- 
? S:tLINES#;2 
? DELETE 

-END OF FILE- 
? R 
? A 

ENTER TEXT. 
? )USED TO RESTRUCTURE INDIVIDUAL) 

READY. 
? ES:+REARRANGING+ 
? A;* 

ENTER TEXT. 
? $ 

READY . 
? L;* 

THE EXTRACT COMMAND CAN BE 
USED TO RESTRUCTURE INDIVIDUAL 
LINES OF TEXT 

VERY USEFUL IN REARRANGING 
LINES OF TEXT. 
REARRANGING 

-END OF FILE- 
? CLEAR 
? S:/VERY/ 
? D* * 

-END OF FILE- 
? ES:*RESTRUCTURE* 

-END OF FILE- 
? RESET 

? ES:*RESTRUCTURE* 
? CHANGES :KINDIVIDUALK 

ENTER TEXT. 



The third line is copied into the string 

buffer. 

The contents of the string buffer are 

inserted into the file. 



Notice that the EXTRACT command does 
not delete the information that it copies 
into the bitffer. 

Advance search pointer to line containing 
second occurrence of string /LINES/ 
and delete line. 



Copy string /REARRANGING/ to string 

buffer. 

Add contents of string btiffer to end of 

file. 

Note that text from previous EXTRACTS 
remains in the string buffer and sub- 
sequent EXTRACTS causes text to be 
appended. 



Clear string buffer. 

Copy string /RESTRUCTURE/ to string 
buffer; command is relative to position 
of search pointer. 

Change string /INDIVIDUAL/ to contents 
of string buffer. 

List to end of file. 
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Entry /'Response 



Commentary 



? $ 

READY . 
? L;* 

THE EXTRACT COMMAND CAN BE 
USED TO RESTRUCTURE RESTRUCTURE 
LINES OF TEXT 

-END OF FILE- 
? DS: /RESTRUCTURE/ 
? A** 

ENTER TEXT. 
? ( REMEMBER THAT THE STRING 
? BUFFER IS NOT CLEARED AFTER AN 
? ADD OR CHANGE $ COMMAND. 
? TO REMOVE TEXT FROM THE STRING 
? BUFFER, USE THE CLEAR COMMAND. ( 

READY. 
? CLEAR 

? ES:# STRING#,#BUFFER, # 
? DS:# STRING*, #BUFFER# 
? ADDS:. THAT THE. 

ENTER TEXT. 
? $ 
? L;* 

THE EXTRACT COMMAND CAN BE 
USED TO RESTRUCTURE 
LINES OF TEXT. 

REMEMBER THAT THE STRING 
BUFFER IS NOT CLEARED AFTER AN 
ADD OR CHANGE $ COMMAND. 

TO REMOVE TEXT FROM THE STRING 
BUFFER. 

IS NOT CLEARED AFTER AN 
ADD OR CHANGE $ COMMAND. 

TO REMOVE TEXT FROM THE STRING 
BUFFER, USE THE CLEAR COMMAND, 

-END OF FILE- 
? CLEAR 

? D: /BUFFER, /,/E STRING/ 
? L;* 

THE EXTRACT COMMAND CAN BE 
USED TO RESTRUCTURE 
LINES OF TEXT. 

REMEMBER THAT THE STRING 
BUFFER IS NOT CLEARED AFTER AN 
ADD OR CHANGE $ COMMAND. 

TO REMOVE TEXT FROM THE STRING 
BUFFER, USE THE CLEAR COMMAND. 

-END OF FILE- 
? END 

END TEXT EDITING. 
READY. 



Delete first occurrence of string 
/EESTRUCTURE/. 



Clear string buffer. 

Note the difference between these two 

ellipsis strings. 

Contents of string buffer is inserted 

after string /THAT THE/. 



Clear string biiffer. 
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EDIT FILE DIMENSIONING COMMANDS 

The LENGTH and WIDTH commands are used to respecify the dimensions of the edit 
file. The ALIGN command removes extraneous blanks for printing purposes. 

LENGTH COMMAND (LENGTH) 

The LENGTH command limits the number of lines of the edit file on which other edit 
comm.anuS can operaie anu £u.so resets me searcn pointer to the first line. Multiple 
truncations are allowed to a maximimi of eight. 

The following are valid forms of the command. 

Command Explanation 

LENGTHjn Truncates the edit file at line n. All text 

information beyond line n is saved in a 
scratch file SCR3. Information in SCR3 is 
not affected by editing commands. 

LENGTH;* Restores original processing bovindaries of 

the edit file by appending the contents of 
scratch file SCR3 to the edit file. This 
version of the command is meaningful only 
if a LENGTHjn command has been given 
previously. 



CAUTION 



A truncated file must be restored (with the 
LENGTH;* command) prior to entering the 
END command or the information that was 
trimcated is lost. 

WIDTH COMMAND (WIDTH OR W) 

The WIDTH command defines the maximum number of character columns that can be 
contained in a single line of the edit file when used with the ALIGN command. The 
command has no effect unless followed by an ALIGN command. 

The format is: 

WIDTH;n 

where n is the new line length, and 6 < n < 150. Note, however, that if n is larger 
than the size of the carriage, over-print may result on the right-hand end of a printed 
line. 

Following a WIDTH command, the ALIGN command can be used to remove superfluous 
blanks and reformat in accordance with the changed right margin. 
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ALICjN V wMM an D I a LiCj N Ok AL) 

The ALIGN command eliminates extraneous blanks from the edit file, while retaining 
the structurail integrity of words, sentences, and paragraphs. 



A word is defined as a set of characters between spaces, 
a group of words ending with a period (or question mark), 
graph is defined by an indented sentence. 



A sentence is defined as 
The beginning of a para- 



The ALIGN command indents five spaces at the beginning of each paragraph, separates | 

each word with one blank, and separates each sentence (group of words ending with a I 

period or question mark) with two blanks. Blank lines are not removed as it is I 

assumed that they serve a purpose in delimiting paragraphs and lines. I 

The following are valid forms of this format control command. 



Com.mand 



ALIGN 



ALIGN;n 



ALIGN: /string/ 



ALIGN:/ string /;n 



ALIGN: /stringl/, /string2/ 



ALIGN :/stringl/, /string2/;n 



Explanation 

Removes excess blanks between words in the 
line of text specified by the search pointer. 

Removes excess blanks between words in n 
lines of text beginning at the search pointer. 
As many complete words as possible are 
placed in a line before starting another line. 

Removes blanks from the line of text containing the 
specified string; search for string begins at 
current position of search pointer. 

Removes blanks from the first n lines containing 
the specified string. 

Removes blanks from the lines of text specified 
by ellipsis /stringl/, /string2/. 

Removes blanks from the first n occurrences 
of the line or group of lines specified by ellipsis 
/ stringl / , / string2 / . 
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The following example illustrates the use of LENGTH, WIDTH, and ALIGN commands. 
Entry /Response Commentary 



EDIT 



7 



BEGIN TEXT EDITING. 

•> TTOT.* 

THE LENGTH COMMAND IS VERY 
USEFUL WHEN IT IS DESIRABLE TO 
WORK ON ONLY A SMALL PORTION 
OF A LARGE FILE. 

THE WIDTH COMMAND IS 
EFFECTIVE ONLY IF FOLLOWED BY AN 
ALIGN COMMAND. 
-END OF FILE- 
? LENGTH; 4 
? WIDTH; 20 
? L;* 

THE LENGTH COMMAND IS VERY 
USEFUL WHEN IT IS DESIRABLE TO 
WORK ON ONLY A SMALL PORTION 
OF A LARGE FILE. 

-END OF FILE- 
? LENGTH;* 
SET; 4 
ALIGN ; * 
RESET 
. L;* 

THE LENGTH COMMAND IS VERY 
USEFUL WHEN IT IS DESIRABLE TO 
WORK ON ONLY A SMALL PORTION 
OF A LARGE FILE. 

THE WIDTH 
COMMAND IS EFFECTIVE 
ONLY IF FOLLOWED BY 
AN ALIGN COMMAND. 

-END OF FILE- 
? ALIGN 
? L;4 

THE LENGTH 
COMMAND IS VERY 

USEFUL WHEN IT IS DESIRABLE TO 
WORK ON ONLY A SMALL PORTION 
? AL:?VERY?,?WORK? 
? L;* 

THE LENGTH 
COMMAND IS VERY 
USEFUL WHEN IT IS 
DESIRABLE TO WORK ON 
ONLY A SMALL 
PORTION 
OF A LARGE FILE. 

THE WIDTH 



j-iisx xo ena oi tue. 



Truncate edit file at line 4. 
Set width indicator to 20, 
List to end of file. 

Notice that WIDTH command does not 
affect the file unless an ALIGN command 
is used. 

Restore truncated file. 

Align to end of file from line 5 with 
width of 20. 



Align line specified by search pointer. 



Align lines containing ellipsis string 
/VERY/, /WORK/. 
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Entry /Response 



Commentary 



Set width to 62 and align entire file. 



Blank string /WORK ON/. 



COMMAND IS EFFECTIVE 
ONLY IF FOLLOWED BY 
AN ALIGN COMMAND. 

-END OF FILE- 
? W;62 
? AL;* 
? L;* 

THE LENGTH COMMAND IS VERY USEFUL WHEN IT IS DESIRABLE TO 
WORK ON ONLY A SMALL PORTION OF A LARGE FILE. 

THE WIDTH COMMAND IS EFFECTIVE ONLY IF FOLLOWED BY AN 
ALIGN COMMAND. 
-END OF FILE- 
? BLANKS:* WORK 0N# 
? WIDTH; 32 
? AL;* 
? L;* 

THE LENGTH COMMAND IS VERY 
USEFUL WHEN IT IS DESIRABLE TO 

ONLY A SMALL PORTION OF A 
LARGE FILE. 

THE WIDTH COMMAND IS 
EFFECTIVE ONLY IF FOLLOWED BY AN 
ALIGN COMMAND. 
-END OF FILE- 
? RS:* ONLY*,*EDIT* 
? ALIGN; 4 
? L"* 

THE LENGTH COMMAND IS VERY 
USEFUL WHEN IT IS DESIRABLE TO 
EDIT A SMALL PORTION OF A LARGE 
FILE. 

THE WIDTH COMMAND IS 
EFFECTIVE ONLY IF FOLLOWED BY AN 
ALLIGN COMMAND. 
-END OF FILE- 
? END 
END TEXT EDITING. 



Align four lines from search pointer. 
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TABULATION COMMANDS 

The commands DEFTAB, TAB, and LISTAB allow the user to create structured text 
using tab settings. 

DEFTAB COMMAND (DEFTAB OR DT) 

The DEFTAB command defines a single tab character that is later used (when respond- 
mg lO an jiiNiiLri, iJiij\i request/ lo Cause oianK mi lo tne next tao stop. ine tao 
character must not be present in the body of text that is to be created. Each typing 
of the tab character that occurs when entering text is ignored, except for purposes of 
tab control. 

The following are valid forms of the command. 

Command Explanation 

DEFTAB Clears previous tab character definition. 

DEFTAB :/tabchar/ Defines the character tabchar as a tab 

character, 

TAB COMMAND (TAB OR T) 

I The TAB command sets tab stops at specified input columns. Default column numbers 
are 11, 18, 30, 40, and 50. 

The following are valid forms of the command. 

Command Explanation 

TAB Clears existing tab stops. 

TAB: /tj.tg. . . . .t^/ Each ti is a column number, ti> 0. A 

maximimi of seven tab column numbers 
may be specified. 

Only one TAB command can be active at one time. Entering a TAB command negates 
the effect of any prior TAB command. 

Since tabulation specification applies to input text, it m.ust be made before the text 
is entered. If the user forgets his tab specifications and enters tabbed text, he has 
to either begin over or use the RS or CS commands to replace each tab character in 
the text with the correct number of blanks. For a small file this is no great task but 
for a very large file this can be a formidable effort. Typical of this di&iculty would 
be a user who has entered a long COMPASS program with tab characters in each line 
to establish the columnar formatting of the language and has forgotten to pre-establish 
the tab parameters. It is possible to preserve the coding that has been typed in and 
initiate proper tabbing. Essentially, the procedure is to extract the program, delete 
the remainder of the file, and then build an input file that contains the tab directives 
and the extracted program. The foUoAving example uses a patterned indirect access 
permanent file and four tabbed lines to demonstrate this procedure. 
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Entry/ Response 



Commentary 



GET, MATRIX 

READY. 

EDIT, MATRIX 

BEGIN TEXT EDITING. 
? Lt* 

1 ABCDE 

2 BCDEF 

^ CDEFG 
i nRPRH 

5 EFGHI 

6 FGHI-T 

7 GHIJK 

8 HIJKL 

9 IJKLM 
-END OF FILE- 

? F:/DEFGH/ 
4 DEFGH 
? A 

ENTER TEXT. 
? /#THIS#IS#TAB$LINE#1. 
? #THIS#IS#TAB#LINE#2. 
? #THIS#IS#TAB#LINE#3. 
? #THIS#IS#TAB#LINE#4./ 

READY. 
? R 
? L" * 

1 ABCDE 

2 BCDEF 

3 CDEFG 

4 DEFGH 
#THIS#IS#TAB#LINE#1. 
#THIS#IS#TAB#LINE#2. 
#THIS#IS#TAB#LINE#3 . 
#THIS#IS#TAB#LINE#4 . 

5 EFGHI 

6 FGHIJ 

7 GHIJK 

8 HIJKL 

9 IJKLM 
-END OF FILE- 

? F:/#/ 

#THIS#IS#TAB#LINE#1. 

? EXTRACT; 4 

R 

Dj* 

-END OF FILE- 
? A 

ENTER TEXT. 
? +L;* 
? F: /DEFGH/ 
? DEFTAB ?/♦/ 
? TAB:/6,18,22,40,45/ 



A copy of an indirect access permanent 
file caUed MATRIX is edited with the 
intention of adding four lines of tabulated 
text after the fourth line. 



The added text has the tab character # 
included in each line. However, the user 
has failed to enter tabulation specifications. 



A listing of the edited file reveals the 
oversight. The tab character is still there 
instead of the desired spacing. 



Position to the first line of inserted text 
and extract the four lines of new text. 
This is put in the string buffer. 

The entire original file is deleted. Only 
the name MATRIX remains. 



An input file of edit directives is built. 
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Entry/Response 



Commentary 



? ADD 
? L;* 
? END+ 
READY . 
? L;* 
L;* 
F:/DEFGH/ 

rvcinmnQ- /Jl / 
uEiC ±no i / ir/ 

TAB:/6,18,22,40,45/ 

ADD 

L;* 

END 

-END OF FILE- 
? F:/ADD/ 

ADD 
? ADD 

ENTER TEXT 
? $ 

READY. 
•> L-* 
ADD 

#THIS#IS#TAB#LINE#1. 
#THIS#IS#TAB#LINE#2 . 
#THIS#IS#TAB#LINE#3 . 
#THIS#IS#TAB#LINE#4 . 
L;* 
END 

-END OF FILE- 
? RS:/#/,/+#/ 
? RS:/#4./,/#4.+/ 
? R 
? L;* 
L;* 

F:/DEFGH/ 
DEFTAB:/#/ 
TAB:/6,18,22,40,45/ 
ADD 

+#THIS#IS#TAB#LINE#1 . 
#THIS#IS#TAB#LINE#2 . 
#THIS#IS#TAB#LINE#3. 
#THIS*IS#TAB#LINE#4 . + 
L;* 
END 

-END OF FILE- 
? END 

END TEXT EDITING. 

SRU 0.189 ONTS 

READY. 

RENAME, IN1=MATRIX 

READY . 
GET, MATRIX 

READY . 

EDIT, MATRIX, ,IN1 



The input file is checked with a listing. 



The te3d; in the string buffer is added to 
the input file. 



The necessary delimiters are added. 



The input file is checked with a listing. 



Exit is made from text editor in order 
to use control statements. 



The local copy of MATRIX is renamed 
so as not to conflict with the new copy 
that is obtained with a GET. 



Text editing is reinitiated with the full 
EDIT command. The edit file is MATRIX, 
the mode is normal, and the input file is 
INI. 
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Entry/ Response 



BEGIN TEXT EDITING. 




1 ABCDE 






2 BCDEF 






3 CDEFG 






4 DEFGH 






5 EFGHI 






6 FGHIJ 






7 GHIJK 






8 HIJKL 






9 IJKLM 






-END OF FILE- 






4 DEFGH 






ENTER TEXT. 






READY. 






4 DEFGH 






THIS 


IS 


TAB 


THIS 


IS 


TAB 


THIS 


IS 


TAB 


THIS 


IS 


TAB 


5 EFGHI 






6 FGHIJ 






7 GHIJK 






8 HIJKL 






9 IJKLM 






-END OF FILE- 






END TEXT EDITING. 




READY. 






LIST,F=MATRIX 






1 ABCDE 






2 BCDEF 






3 CDEFG 






4 DEFGH 






THIS 


IS 


TAB 


THIS 


IS 


TAB 


THIS 


IS 


TAB 


THIS 


IS 


TAB 


5 EFGHI 






6 FGHIJ 






7 GHIJK 






8 HIJKL 






9 IJKLM 







Comraentary 



LINE 1. 
LINE 2. 
LINE 3. 
LINE 4. 



A listing of the full edited file confinns 
the success. 



LINE 1. 

LINE 2. 

LINE 3. 

LINE 4. 



READY. 

LISTAB COMMAND (LISTAB OR LT) 

The LISTAB command causes a listing of the tab stops as specified in the most recent 
TAB comjnand. 

The command format is: 
LISTAB 



The system responds: 



TAB STOPS 



*1*2 



n 



If the tab stops have been cleared (refer to TAB command), the system responds: 
TAB STOPS NONE. 
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The following example illustrates the use of TAB, DEFTAB, and LISTAB commands. 
Entry/Response Commentary 



BEGIN TEXT EDITING. 
? ADD 

ENTER TEXT. 
? / THE DEFTAB AND TAB COMMANDS 

ARE EFFECTIVE ONLY IF GIVEN PRIOR 

TO AN ENTER TEXT REQUEST. THUS, 

THE FOLLOWING WILL NOT BE TABULATED. 

1#2#3#4 

5#6#7#8 

NOW DEFINE A TAB CHARACTER 

AND A SET OF TAB STOPS./ 
READY. 
? DEFTAB:/*/ 
? TAB: /5, 10, 20/ 
? ADD;* 

ENTER TEXT. 
? /A#B#C#D 
? E#F#G#H/ 

READY , 
? LIST;* 

THE DEFTAB AND TAB COMMANDS 
ARE EFFECTIVE ONLY IF GIVEN PRIOR 
TO AN ENTER TEXT REQUEST. THUS, 
THE FOLLOWING WILL NOT BE TABULATED. 
1#2#3#4 
5«6f7#8 

NOW DEFINE A TAB CHARACTER 
AND A SET OP TAB STOPS. 



Define the character # as the tab 
character with stops at 5, 10, and 20. 



ABC 
E F G 

-END OF FILE- 
? LISTAB 

TAB STOPS 5 
? DEFTAB 
? TAB 
? LT 

TAB STOPS NONE. 
? END 

END TEXT EDITING. 



D 
H 



10 20 



Clears previous tab character. 
Clears existing tab stops. 
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EXTERNAL FILE MERGE 

MERGE COMMAND (MERGE OR M) 

The MERGE command causes the contents of a specified file (working or permanent) 
to be merged into the edit file. 



The following are valid forms of the com.mand. 



uommana 

MERGE :/lfn/ 
MERGE :/lfn/;n 
MERGE :/pfn/ 
MERGE :/pfn/;n 

MERGE :/lfn/, /string/ 
MERGE:/lfn/, /string/; n 
MERGE :/pfn/, /string/ 
MERGE :/pfn/, /string/;n 



Explanation 



The contents of file Ifn or pfn are inserted 
into the edit file. Merging takes place after 
the nth line of the edit file, relative to the 
search pointer. 

The contents of file Ifn or pfn are inserted 
into the edit file. Merging takes place after 
the nth line that contains /string/ and only if 
n lines containing /string/ are fo-und. 



MERGE is the only Text Editor command that can reference a working file (Ifn) or a 
permanent file (pfn). The file referenced cannot be the current edit file or any other 
reserved file name (refer to appendix C). If pfn is a direct access permanent file, it 
must be attached to the user's job before entering Text Editor (refer to the NOS 
Time-Sharing User's Reference Mantial for information regarding direct access file 
usage). 



NOTE 



Whenever a MERGE command is issued, the 
data entered in response to the most recent 
ENTER TEXT request is lost. Therefore, a 
@ only in response to an ENTER TEXT re- 
quest causes no data to be added (refer to the 
ADD command and the CHANGE command). 
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The following example illustrates the use of MERGE command. 



Entry /Response 
LNH,F=TXT2 

THIS FILE IS NAMED TXT2 
AND IS A COPY OF AN INDIRECT 
ACCESS PERMANENT FILE OF THE 
SAME NAME, 
READY. 
NEW XYZ 

READY. 
EDIT 

BEGIN TEXT EDITING. 
? ADD 

ENTER TEXT. 
? / THIS FILE IS BEING BUILT 
? USING THE TEXT EDITOR ADD 
? COMMAND./ 

READY. 
? L** 

THIS FILE IS BEING BUILT 
USING THE TEXT EDITOR ADD 
COMMAND. 

-END OF FILE- 
? MERGE :/TXT2/;* 
? L;* 

THIS FILE IS BEING BUILT 
USING THE TEXT EDITOR ADD 
COMMAND. 

THIS FILE IS NAMED TXT2 
AND IS A COPY OF AN INDIRECT 
ACCESS PERMANENT FILE OF THE 
SAME NAME. 

-END OF FILE- 
? MERGE: /TXT 2/, /INDIRECT/ 
? L;* 

THIS FILE IS BEING BUILT 
USING THE TEXT EDITOR ADD 
COMMAND. 

THIS PILE IS NAMED TXT2 
AND IS A COPY OF AN INDIRECT 

THIS FILE IS NAMED TXT2 
AND IS A COPY OF AN INDIRECT 
ACCESS PERMANENT FILE OF THE 
SAME NAME. 

ACCESS PERMANENT FILE OF THE 
SAME NAME. 

-END OF FILE- 
? END 
END TEXT EDITING. 



Commentary 
Before entering Text Editor, time-sharing 
conamands are used to list working file 
TXT2, which is a copy of a permanent file. 



Working primary file XYZ created, re- 
leasing working file TXT2. 

Enter Text Editor with empty primary file 
XYZ as the edit file. 



Merge permanent file TXT2 to end of edit 
file. 



Merge permanent file TXT2 after first 
occurrence of string /INDIRECT/. 
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STRING INCIDENCE COUNTING 

NUMBER COMMAND 

The NUMBER command provides a count of lines in a file or a count dependent on the 
presence of a specified string of characters. The count always begins relative to the 
search pointer. 

LINE MODE FORMATS {NUMBER OR N) 

Command Explanation 

NUMBER Returns a line count from current search 

pointer value to end-of-file. 

NUMBER: /string/ Returns a count of the number of lines in 

NUMBER :/stringl/, /string2/ the edit file that each contain the entire 

specified string or ellipsis. 

STRING MODE FORMATS (NUMBERS OR NS) 

Command Explanation 

NUMBERS Same as NUMBER 

NUMBERS :/string/ Returns a count of the number of occurrences! 

NUMBERS:/stringl/, /string2/ of the specified string. Note that the string 

can be either single phrase or ellipsis. I 
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The following example illustrates the use of NUMBER command. 



Entry /Response 
BEGIN TEXT EDITING. 
? L;* 

00005***THIS PROGRAM GENERATES 
00006* 10 RANDOM NUMBERS BETWEEN 
00007* 1 AND 100. 
00010 PROGRAM RANDOM (OUTPUT) 
00020 MAINSD = 5**13 
00030 NEXTSD = 5**17 
00040 H100 = 1 ./100. 
00050 BIG = 2.**48 
00060 FRAC = H100*BIG 
00070 IFRAC = INT (FRAC) 
00080 DO 20 I = 1,10 
00090 INC = 

00100 NEXTSD = NEXTSD*MAINSD 
00110 10 INC = INC+1 

00120 IF ( (INC*IFRAC) .LT. NEXTSD) GO TO 10 

00130 NRAN = INC 

00140 PRINT 30, I, NRAN 

00145 30 FORMAT(I2,2X,I4) 

00150 20 CONTINUE 

00160 END 

-END OF FILE- 
? NUMBER 

20 LINES TO EOF. 
? NUMBER: /NEXTSD/ 

3 OCCURANCES OF PHRASE FOUND. 
? NUMBERS : /NEXTSD/ 

4 OCCURANCES OF PHRASE FOUND. 
? S;10 

? N 

10 LINES TO EOF. 
? NS:/INC/,/0/ 

4 OCCURRENCES OF PHRASE FOUND. 
? LISTS:/INC/,/0/;* 
INC = 

INC = INC+1 
INC*IFRAC) .LT. NEXTSD) GO TO 10 

INC 



Commentary 
List to end of file. 





■p 


N:, 


/INC/,/0/ 

3 OCCURRENCES 


OF 


PHRASE 


FOUND. 


? 

? 

? 


K 

NS: /MAINSD/ 

2 OCCURENCES ( 
NS: /PRINT/ 

1 OCCURRENCES 
END 


3F ] 
OF 


PHRASE 1 
PHRASE 


FOUND . 
FOUND. 


1 


SND 


TEXT EDITING. 









Request line count from search pointer 
to end of file. 

Request count of number of lines con- 
taining string /NEXTSD/. 
Request count of number of occurrences 
of string /NEXTSD/. 

Request line count from search pointer 
to end of file. 

Request count of occurrences of 
ellipsis string /lNC/,/0/. 

Actual occurrences of ellipsis string 
/INC/,/0/ are listed. 



Request count of number of lines con- 
taining ellipsis string /lNC/,/0/. 

Request count of occurrences of 
string /MAINSD/ in file. 
Request count of occurrences of 
string /PRINT/ in file. 
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TERMINATING EDIT SESSION 

END COMMAND (END) 

The END command terminates text editing (that is, exits from EDIT program control) 
and returns control to the subsystem control language. 

The command format is: 

END 
The system responds 

END TEXT EDITING. 

It is necessary to terminate text editing whenever it is necessary or desirable to do 
a file operation (such as SAVE or REPLACE). 

The user may also end text .editing by typing STOP after the execution of an edit com- 
mand. This immediately terminates the edit session and the terminal is no longer under 
Text Editor control. In this case, the text file contents are unpredictable and all output 
files may be lost. 

This method of termination would be used in situations where the contents of files are 
to be examined but are not required after the edit session. 
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SYSTEM ACCESS PROCEDURES A 



LOG-IN SEQUENCE 

1. Complete the dial-in procedure to connect the terminal to the NOS Time-Sharing 



parity, baud rate, etc. ) are set to the correct position. 






2. When the dial-in procedure is complete, it may be necessary to identify the 
t3rpe of terminal being used before proceeding. 

Terminal Type Identification 

Correspondence code Press ATTN key 

terminal /standard print 

Correspondence code Type A and press 

terminal /APL print ATTN key 

ASCII code terminal/ Press @ 

standard print 

Memorex 1240 (ASCII code) Type A 

terminal /APL print 

Block transmission (ASCII Type B 

code) terminal /standard print 

3. When communication with NOS is established, the system types out three lines. 
The first line is in the format 

yy/mm/dd. hh. mm. ss. 

which gives the date and the time. The second line is the identifying header 
of the installation. In this manual, the examples use 

CDC MULTI-MODE OPERATING SYSTEM NOS 

The third line is a request for a family name 

FAMILY: 

The user types in the name of the family to which he is assigned and presses 
carriage return. If he is using the default family, he only presses carriage 
return. 

4. There follows a request for the user n\miber. The format is 

USER NUMBER: 
The user number is typed in on the same line and the carriage return depressed. 

5. The system request the user's password as follows: 

PASSWORD 
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The user types his password over the darkened area and presses carriage 
retxirn. If he is not using a password, he only presses carriage return. 

If the family name, user number, or password are not acceptable, the system 
responds 

IMPROPER LOG IN, TRY AGAIN 
FAMILY: 

If the user is unsuccessful at logging in four times in succession, the system 

ILLEGAL TERMINAL, 
and disconnects the terminal. 

6. If the family name, user number, and password are acceptable, the system 
prints the identifying number and type of the terminal on the next line. An 
example would be 

TERMINAL: 45, TTY 

7. The system follows this with either 

RECOVER/CHARGE 

or with 

RECOVER/SYSTEM: 

If recover/charge was issued, the user types in the word CHARGE and 
follows it with his charge nximber and project ntimber. The system responds 
with 

READY. 

The user then enters the name of the subsystem to be used or any valid 
command. 

If RECOVER/SYSTEM was issued, the user immediately enters the name of 
the subsystem to be used or any valid command. 

8. If the subsystem entered above was BATCH, the system responds with 

$RFL, 20000 (or a specified filed length) 

The user then begins entering commands. 

If the subsystem entered above was BASIC, FTN, or EXECUTE, the system 
responds with 

OLD, NEW, OR LIB FILE: 

The user response is one of the following: 

OLD @ This references a file that was previously saved 

as an indirect access permanent file. 

NEW @ This establishes a new primary working file. 

LIBRARY @ This references an indirect access permanent file 

that resides in the catalog of the special user 
ntimber library. 



A-2 



60436100 C 



The system responds: 

FILE NAME: 

The user then enters the one to seven character name of the file he is access- 
ing or creating. He follows this with a carriage return. 

If no errors are detected, the system responds: 
READY. 

The following is a typical log in: 

yy/mni/ss. hh.mm.ss. 

CDC MULTI-MODE OPERATING SYSTEM. NOS 
FAMILY: 

USER NUMBER; EFD2501 
PASSWORD 
hHDDWBO 

TERMINAL: 16,TTY 
RECOVER/CHARGE : CHARGE , 2 3 , 9 3N1 56 

READY. 



LOG-OFF SEQUENCE 

When the user wishes to terminate the session, he logs off the system by entering the 
BYE or GOODBYE command. All current working files are then released and the 
system prints 

(user nimiber) LOG OFF. hh.mm.ss. 
(user mmiber) SRU s. ss UNTS 

and disconnects the terminal. The designation hh.mm.ss. is the time of log off, and 
s. ss is a measure of the system resources used from log in to log off. 
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SYSTEM FILE MANAGEMENT B 



GENERAL 

This appendix is included to provide the inexperienced user with enough information to 
perform basic file operations using the NOS Time-Sharing System. The outlined 
techniques are not necessarily the only ways to accomplish a given result, nor neces- 
sarily the most efficient. Direct access permanent files are not discussed at length 
since a user's first exposure to the Text Editor normally incorporates the use of work- 
ing files and indirect access perm.anent files. 

For more detailed information on NOS file handling, refer to the NOS Time-Sharing 
User's Reference Manual. Also, if operating under the batch subsystem, refer to the 
NOS Reference ManuEul, volume 1. 

FILE TYPES 

A clear understanding of files is vital to efficient use of the Text Editor. There are 
basically two types of files that the user can be associated with, working files and 
direct access files. It is important that the Text Editor user be aware of the type 
of file that is being edited and the effect of such editing to the file. There are pri- 
marily two cases to remember: either the file being edited is a copy of a file or it is 
the original file. In the latter instance, extreme care must be exercised since all 
changes affect the only existing copy of the file being edited. 

WORKING FILES 

Generally, a working file is either a new file, created by the user, or a copy of a 
file that already exists in the system (refer to Indirect Access Permanent Files). All 
working files are temporary in nature and can exist no longer than the user is logged 
into the system. Working files may be created, accessed, and released at the dis- 
cretion of the user while he is logged into the system, but they are automatically re- 
leased when he logs off the system. 

Working files may also be referred to as local files. The parameter Ifn on most 
time-sharing commands and permanent file commands signifies a local file name. 
Therefore, throughout this manual, the terms are synonymous. 

PRIMARY FILES 

The primary file is a working file that has special significance in certain system 
commands. In general, those time-sharing commands that have the optional Ifn para- 
meter reference the primary file If the parameter is omitted. There is at most one 
primary file active or available to the user at any given time. 

INDIRECT ACCESS PERMANENT FILES 

An indirect access file is a permanent file situated on mass storage. When accessed 
the system generates a copy of the indicated perma«ent file which becomes a working 
file. Alterations to the working copy have no effect on the original permanent file. 
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DIRECT ACCESS PERMANENT FILES 

A direct access file is also a permanent file situated on mass storage. When accessed 
the file becomes linked directly to the user's job. No copy of the permanent file is 
created; hence, all editing and other alterations are performed directly on the permanent 
file itself. A direct access file cannot become a working file or primary file. 

FILE HANDLING PROCEDURES 

This section discusses briefly the file handling procedures and commands commonly 
used in conjunction with the Text Editor. Its purpose is to provide simple procedures 
that work; it does not reflect the full range of file handling capability. 

CREATING A WORKING FILE 

A working file is created either as a new file or as a working copy of an indirect 
access file. To create a new file, enter: 

NEW @ 

The system responds: 

FILE NAME: 

and a valid file name should be entered. The name should be different from aU 
permanent file names currently stored under the user number if the file is to be made 
permanent at a later time. When the system accepts the file name, it responds: 

READY. 
The two steps can be combined into one by entering: 

NEW, If n @ 

where Ifn is the name of the file. 

A working file created with a NEW, OLD. or LIBRARY command also becomes the 
primary file. To create a working file that is a copy of an indirect access permanent 
fil^ enter the OLD or LIBRARY (for a library file) command. 

OLD, pfn @ 

With this command, a copy of the indirect access permanent file pfn becomes the 
primary working file. To give the copy of pfn a different working file name Ifn. use 
the command: 

OLD, lfn=pfn @ 

I In both of the previous commands, LIBRARY can be substituted for OLD with the copy 
being made from a library file. 
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To retrieve a copy of an indirect access permanent file without affecting the current 
primary file or if" no primary file is desired, use the command: 

GET,pfn @ 

The permanent file pfn is copied as a working file and the primary file is unaffected. 
To access the permanent file pfn under a different name, enter the command: 

GET,lfn=pfn @ 

^,„-U _. . U__ 2 « Xl- «. «n... «««. -wkn rt-P 4-1% Q t■rry\.■*t^yi■r^\l^ -PiTl A *^ rN -(-i i Q rl "Pl^i^-rVl l-VOT^TVl QnOn+ "F-1 1 T^-fr* 

\^0cl'C JLlIl ICS LIIC new llELlllC: Wl tilC W V/X A.J.Ll.g J.J.xi? ^\/yi.\^\A xx \^i.xx ^Cj. AXJ.4a.I.J.^^l.Al. j.j.A^ ^j.i.xa 

In either a GET, LIBRARY, or OLD command, the choice of using the single file 
name (pfn) or the double file name specification (lfn=pfn) depends on what the user 
intends to do with the working file. If it is desired to store the working copy (with 
or without alterations) as a permanent file without disturbing the current version of 
file pfn, it is necessary to use an Kn=pfn specification or a RENAME command (dis- 
cussed later) at some point in the processing of the file (although not necessarily when 
the file is first accessed). 

A working file can also be created when entering Text Editor. The command: 

EDIT, Ifn @ 
creates an empty working file named Ifn if one does not already exist. 

CREATING AN INDIRECT ACCESS PERMANENT FILE 

To retain a copy of a working file on mass storage as an indirect access permanent 
file, enter the command: 

SAVE @ 

to store the primary file, or: 

SAVE, Ifn @ 

to store the working file Ifn (Ifn can also be the name of the primary file). If the 
system responds: 

Ifn ALREADY PERMANENT 

a permanent file named Ifn already exists. To save the working file in this case, 
enter the command: 

SAVE, lfn=pfn @ 

where pfn is different from the name Ifn. This causes the working file Lfn to be saved 
permanently under the permanent file name pfn. 

When the system responds: 

READY. 

the working file is established as a permanent file. 
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CAUTION 



Newly created files should generally be saved prior 
to editing as a precautionary measure. Some Text 
Editor commands are powerfiil and can ruin a work- 
ing file if the user makes a mistake. Also, it may 
be desirable to exit from the Text Editor at various 
stages of the edit procedure to save the edit file. 

REPLACING A PERMANENT FILE 

f^i^J ""^J"^ °^ an indirect access permanent fUe is obtained and alterations are per- 
formed. It IS possible to replace the former version with the altered version If the 
workmg copy is obtained with the command: 

OLD, pfn @ 

the subsequent command: 

REPLACE @ 

ing^alteratiil^s'''"^"^"* ^^^ ^^" *° ^^ ^"""^^"^ "'"'' '"^P^^'^^^ ^^^^ the working copy, includ- 

The REPLACE command without parameters acts as a SAVE if the primary file does 
not have the same name as a permanent file. The command: 

RE PLACE, If n @ 

causes working file Ifn to replace a permanent fUe of the same name if such a file 
exists; otherwise, it is equivalent to the command: 

SAVE, Ifn @ 
The command: 

RE PLACE, lfn=pfn @ 

causes working fUe Ifn to replace the current contents of permanent file pfn. 

2,0'.^^ V'?L°''*f*"* *° "^^ caution in the use of the REPLACE command or any other com- 
mand that alters a permanent file. In a long session at the terminal, it is not un- 

« fT^Jlnf ^ "^f *^ ^°f^^i T^^* *^^ primary fUe name is, and inadvertently specify 
a file replacement not intended. For example, h "-"j- 

OLD, BLAB 
GET.' GAB=BLAB 



B-4 

60436100 A 



Two copies of the permanent fQe BLAB now exist as working files. If alternations are 
done on GAB, and the user enters the command: | 

REPLACE @ 

the permanent file BLAB does not receive the changed version. Instead, the user 
shoxd.d enter 

REPLACE, GAB=BLAB. @ 

BUILDING A FILE 

Several methods of building a file are available. EDIT can be entered immediately 
and the file built using Text Editor commands, as explained in Adding and Building 
Text in section 3. Also, various time-sharing commands can be used. For information 
on the latter, refer to the following sections of the NOS Time -Sharing User's 
Reference Manual. 

Section 3: File Sorting 

Section 4: Terminal Control Commands (AUTO, NORMAL); Time- Sharing Job 
Commands (NOSORT, PACK, SORT, TEXT). 

RENAMING A WORKING FILE 

The command: 

RE NAME , If ni =Lf ng @ 

changes the name of working file lfn2 to Ifn^. If another working fQe has the name 
Ifni, that file is released. 

Example : 

OLD.TXTFILE 



RENAME. TXTFL1=TXTFILE 
SAVE 

The working file is saved as TXTFLl without affecting the permanent file TXTFILE. 

LISTING A FILE 

Any working file can be listed with the command: 

LIST, F=lfn @ 
or 

LNH, F=lfn @ (List with no header) 
The F=lfn parameter may be omitted if the primary file is being listed. 
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If the file has line munbers, begin the listing at line n with the command: 
LIST, n @ 



or 

LNH,n 



@ 



The n parameter and F=lfn cannot be used in the same command, 
is used, the file must be sorted to obtain an accurate listing. 



If the n parameter 



ANNOTATED SAMPLE TERMINAL SESSION 

The following sample terminal session illustrates the use of NOS file handling commands 
described earlier in this appendix. Several other commands, such as TEXT and RUN, 
are used in the example; although not directly related to Text Editor usage, they tend 
to be used frequently in a typicsd terminal session. 



Entry / Response 

yy /mm/dd . hh . mm . s s . 

CDC MULTI-MODE OPERATING SYSTEM 
FAMILY: 

USER NUMBER: USER123 
PASSWORD 



NEW 



TERMINAL: 10,TTY 

RECOVER/SYSTEM: NULL 

OLD, NEW, OR LIB FILE: 

FILE NAME: TXTl 

READY. 

TEXT 

ENTER TEXT MODE. 



THIS FILE IS BEING CREATED 
IN TEXT MODE. IT DOES NOT 
REQUIRE LINE NUMBERS. 



EXIT TEXT MODE. 
PACK 

READY. 



Commentary 



NOS 



User USER123 logs in, entering the NULL sub- 
system and creating a new file named TXTl. 



User enters text mode because data to be 
entered do not have line nxmibers. 



To terminate text mode, press the interrupt 

or break key from an ASCII code terminal or 

the ATTN key from a correspondence code 

terminal. 

The PACK command compresses the file into 

one record. 



LIST 

yy /mm/dd. hh.mm.ss. 
PROGRAM TXTl 

THIS FILE IS BEING CREATED 
IN TEXT MODE. IT DOES NOT 
REQUIRE LINE NUMBERS. 
READY. 



The primary file is listed with header infor- 
mation. 



SAVE 
READY. 



TXTl, the primary file, is stored as an in- 
direct access permanent file. 
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Entry /Response 



Commentary 



GET, FRAN 2 
READY . 

LNH,F=FRAN2 



00005***THIS PROGRAM GENERATES 
00006* 10 RANDOM NUMBERS BETWEEN 
00007* 1 AND 100. 

aaai a porkppAM pnMr\i^u /nrTTinnrn^ 

00020 MAINSD = 5**13 

00030 NEXTSD = 5**17 

00040 H100 - 1./100. 

00050 BIG = 2.**48 

00060 FRAC = H100*BIG 

00070 IFRAC = INT (FRAC) 

00080 DO 20 I = 1,10 

00090 INC == 

00100 NEXTSD = NEXTSD*MAINSD 

00110 10 INC = INC+1 

00120 IF((INC*IFRAC) .LT. NEXTSD) GO TO 10 

00130 NRAN = INC 

00140 PRINT 30, I, NRAN 

00145 30 FORMAT(I2,2X,14) 

00150 20 CONTINUE 

00160 END 

READY. 



A copy of permanent file FEAN2 is obtained 
as a working file. 

The file is listed without header inform.ation. 
The F parameter is used to distinguish this 
file from the prim.ary file, TXTl. 



PTN 




RETURN. 


RUN,I= 


=FRAN2 


1 


46 


2 


45 


3 


54 


4 


88 


5 


73 


6 


94 


7 


97 


8 


21 


9 


57 


10 


44 


00'746 





The FORTRAN subsystem is entered to ex- 
ecute the program. 

The RUN com.mand causes the program to be 
executed. The I parameter is necessary to 
execute a file other than the primary file. 



SRU 1.110 ONTS. 
RON COMPLETE. 
NEW, TXTl 

READY. 

001 PROGRAM OUT (OUTPUT) 

002 PRINT 10 

003 10 FORMAT (* PROGRAM OUT*) 

004 END 
RNH 



A new empty primary file named TXTl is 
created, releasing the previous primary file 
of the same name. 



Rtin program with no header. 
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Entry /Response 



PROGRAM OUT 



SRU 0.857 UNTS 

RUN COMPLETE. 
SAVE 

mvntl RTBC»Ar*v nonu iiMC>»m 

SAVE,TXT1=0UT 
READY. 

OLD , TXT=TXT1 
READY. 

TEXT 

ENTER TEXT MODE. 

THIS SHOULD BE ADDED TO 
THE END OF THE FILE. 

EXIT TEXT MODE. 
PACK 

READY. 



Commentary 

TXTl is a simple FORTRAN program that 
produces one line of output. 



Attempt is made to save file TXTl, but a 

Thus, the user stores the new file imder 
the different name, OUT. 



A copy of permanent file TXTl becomes the 
primary file with the name TXT, 

An addition is raade to primary file TXT in 
text mode. Permanent file TXTl is unaffected. 



Compress into one record. 



LNH 

THIS FILE IS BEING CREATED 
IN TEXT MODE. IT DOES NOT 
REQUIRE LINE NUMBERS. 

THIS SHOULD BE ADDED TO 
THE END OF THE FILE. 
READY. 



Primary file is Hstedi 



RENAM E , NEWTXT=TXT 



Rename fUe TXT to NEWTXT. 



CP 
READY. 



0.001 SECS. 



RE PL AC E , NEWTXT-TXT 1 
READY. 

0LD,TXT1 
READY. 

LNB 

THIS FILE IS BEING CREATED 
IN TEXT MODE. IT DOES NOT 
REQUIRE LINE NUMBERS. 

THIS SHOULD BE ADDED TO 
THE END OF THE FILE. 
READY . 



File NEWTXT replaces the contents of per- 
manent file TXTl. Finally, permanent file 
TXTl is accessed and listed to reflect the 
changes. 
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Entry/Response Commen.taiy 

BYE USER123 logs off. 

USER123 LOG OFF 17.47.02. System supplies log off information, including 

USER123 SRU 1.662 UNTS. system resources used. 
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EDIT MESSAGES 



EDIT ERROR MESSAGES 

These messages indicate a condition that prevents processing of the command. 

CONTROL CARD ERROR. 

More than two parameters were passed when calling the Text Editor or an illegal 
second parameter was supplied. 

ILLEGAL COMMAND. 

The command word is invalid. 

ILLEGAL DELIMITER. 

An invalid delimiter was entered in response to the ENTER TEXT request from a local 
or remote batch job. 

iJ-iijUiuAij jjJiijiMiTiiiR - j^,EiriiN i liin iii^^j.. 

An invalid delimiter was entered in response to the ENTER TEXT request from a 
time -sharing job. 

ILLEGAL FILE NAME. 

The file name, passes with MERGE command is illegal. 

IMPROPER TRUNCATION. 

Length specified in LENGTH; n command is equal to or greater than previous length 
specified. 

MERGE ERROR, SECONDARY FILE EMPTY. 
One of these conditions exists: 

1. The file to be merged with the edit file is empty, 

2. The file to be merged does not exist. 

3. The file to be merged is a direct access file that was not attached to user's 
job prior to entering Te'xt Editor. 
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PHRASE NOT FOUND. 

The search string specified in /string/ was not found in the edit file. 

RESERVED FILE NAME. 

The file name passed with MERGE command or when invoking Text Editor is reserved 
for use by Text Editor. Reserved file names are: leservea 



INPUT 


SCRl 


SCR4 


OUTPUT 


SCR2 


SCR5 


SCR 


SCR3 


name of current edit file 



cmd SYNTAX ERROR. 

String and/or n parameter is illegal with command cmd. 

REQUESTS AND INFORMATIVE MESSAGES 

These messages are issued in the course of normal edit operation. 

BEGIN TEXT EDITING. 

™^m^nd^^^ ^^ issued when initialization of editor is complete and awaiting the first 

CONTINUE COMMAND? (YES or NO) 

This is an inquiry as to whether or not an interrupted command should continue to be 
processed. 

DISREGARD PREVIOUS TEXT? (YES or NO) 

This is an inquiry as to whether the text that has been entered in response to a text- 
entering command should be retained or discarded. 

-END OF FILE- 

The search pointer is currently set at end of file or end of file encountered during 
execution of a LIST command. ""xi-iig 

END TEXT EDITING. 

t™s^uS^ste]?mode^^''^'^ following execution of the END command, indicating a return 

ENTER TEXT. 

^oZi^lnS^^^^^^^^ *^^ ^^ required to process ADD (ADDS) or CHANGE (CHANGES) 
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ENTEK TiUXT FILJi NAMiL'. 

This message is issued when teirt file name is not passed with Text Editor call. 

FILE AT LINE NUMBER m. 

This message is a current search pointer value, issued by LINE command processor. 

INTERRUPT AT LINE m. 

This message informs the user of the current position of an interrupted command. 

m LINES TO EOF. 

This message is a line coimt message issued by NUMBER command processor. 

m OCCURRENCES OF PHRASE FOUND. 

End of file was encountered before number of iterations specified in n paraxneter 
were completed. 

READY. 

The response to an ENTER TEXT request is completed; that is, the last carriage 
ret^irn was preceded immediately by the closing deiuniter. 

TAB STOPS ti tg ... tn 

This message is a list of tab stops issued by LISTAB command processor. 
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BATCH USAGE OF TEXT EDITOR 



Text Editor commands can be used by a batch job if it includes the EDIT control 
statement in it's control statement record. Format of this control statement is: 



EDITdftij, m, Ifng, Hn^ ) 

or 
EDIT(FN=lfnj, M=m, I=lfn2, L=lfn3) 

Ifnj Name of the file to be edited, 

m Mode of file processing 

N Normal (default) 

AS ASCII 

IfHp File from which the edit commands are to be read. The default 

is a record in the job deck (INPUT). 

Ifno File on which the output is written. Default is OUTPUT which is 

routed to the printer. 

Example : 

A batch job contains a record listing six types of cable assemblies and the amounts 
on hand. The job calls on Text Editor to produce two listings of specific types. The 
deck is shown in figure D-1, The cable list is the second record in the INPUT file. 
This is copied to a local file and given the name PARTS, 

The EDIT command references PARTS which is automatically rewound. The mode of 
file processing is normal. The missing parameter after the comma indicates the 
source default of INPUT, This means the editing commands are taken from, the next 
record in the job deck. This is the one following the list of six cables. 

TEMP identifies a temporary file on which the restilts of editing are written. These 
results are not routed directly to the printer since, at this point, allowance has not 
been made for carriage control by the first character of each line. 

■nie temporary file TEMP is copied to the OUTPUT file with a COPYSBF which moves 
the text over one colum.n leaving the first position of each line blank. This causes 
single spacing. 
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CABLES, TIO. 






USER,XYZ22. 






CHARGE, 5N2201, 23J8. 






COPYCR(, PARTS) 






EDIT(PARTS, N, , TEMP) 






REW[ND(TEMP) 






COPYSBF(TEMP, ) 






end- of- record 






CABLE, 4- WIRE, 6-POOT 


ON-HAND 


22 


CA.BT,E, 4-V.1RE, 8-FOOT 


ON-HAND 


09 


CABLE, 6-WIRE, 6-FOOT 


ON-HAND 


03 


CABLE, 6-WIRE, 8-FOOT 


ON-HAND 


11 


CABLE, 8- WIRE, 6-FOOT 


ON-HAND 


01 


CABLE, 8- WIRE, 8- FOOT 


ON-HAND 


19 


end-of-record 






LIST:/6-FOOT/;* 






T,TST:/8-WIRE/;* 






END 






end-of- information 






Printout from execution 




of the above job 






BEGIN TEXT EDITING. 






CABLE, 4- WIRE, 6-FOOT 


ON-HAND 


22 


CABLE, 6-WIRE, 6-FOOT 


ON-HAND 


03 


CABLE, 8- WIRE, 6-FOOT 


ON-HAND 


01 


-END OF FILE- 






CABLE, 8- WIRE, 6-FOOT 


ON-HAND 


01 


CABLE, 8- WIRE, 8-FOOT 


ON-HAND 


19 


-END OF FILE- 






END TEXT EDITING. 







Figure D-1. Batch Job Using Text Editor 
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BLANK command 3-12 
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Conventions 1-2 
Creating a new file B-2, 3 



DEFTAB command 3-26 

UHli-jilj lHj (JUlillllcini-i O — Xi. 

Delimiters 2-5 
Direct access file B-2 
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EDIT command 2-1; D-1 

EDIT commands format 2-1; 3-1 
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Edit file dimensioning 3-22 
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File, edit 2-2; 3-22,23 

File handling procedures B-2, 3, 4 
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File, permanent B-1, 2 

File, primary B-1 

File, working B-1, 2 
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INSERTS command 3-8 
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LENGTH command 3-22 

LINE command 3-5 
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LNH command B-5, 6 
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n parameter 2-8 
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TAB command 3-26 
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